A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.
Python artificial-intelligencedagdata-sciencedata-visualizationdataflowdeveloper-toolsmachine-learningnotebookspipelinepythonreactivesqlweb-app
Hover over cell (#6420)
Florian Verdonck8b2562c7db5c
diff --git a/examples/ui/table.py b/examples/ui/table.pyindex 51b483da2d..7256836301 100644--- a/examples/ui/table.py+++ b/examples/ui/table.py@@ -19,7 +19,9 @@ def _(mo):{"first_name": "Michael", "last_name": "Scott"},{"first_name": "Jim", "last_name": "Halpert"},{"first_name": "Pam", "last_name": "Beesly"},- ]+ ],+ # Show full name on hover for each row using column placeholders+ hover_template="{{first_name}} {{last_name}}",)tablereturn (table,)diff --git a/frontend/src/components/data-table/__tests__/data-table.test.tsx b/frontend/src/components/data-table/__tests__/data-table.test.tsxindex b5986f3d14..30a128c4e9 100644--- a/frontend/src/components/data-table/__tests__/data-table.test.tsx+++ b/frontend/src/components/data-table/__tests__/data-table.test.tsx@@ -1,6 +1,6 @@/* Copyright 2024 Marimo. All rights reserved. */import type { ColumnDef, RowSelectionState } from "@tanstack/react-table";-import { render } from "@testing-library/react";+import { render, screen } from "@testing-library/react";import { describe, expect, it, vi } from "vitest";import { TooltipProvider } from "@/components/ui/tooltip";import { DataTable } from "../data-table";@@ -57,4 +57,42 @@ describe("DataTable", () => {// Verify the rowSelection prop is maintainedexpect(commonProps.rowSelection).toEqual(initialRowSelection);});++ it("applies hoverTemplate to the row title using row values", () => {+ interface RowData {+ id: number;+ first: string;+ last: string;+ }++ const testData: RowData[] = [+ { id: 1, first: "Michael", last: "Scott" },+ { id: 2, first: "Jim", last: "Halpert" },+ ];++ const columns: Array<ColumnDef<RowData>> = [+ { accessorKey: "first", header: "First" },+ { accessorKey: "last", header: "Last" },+ ];++ render(+ <TooltipProvider>+ <DataTable+ data={testData}+ columns={columns}+ selection={null}+ totalRows={2}+ totalColumns={2}+ pagination={false}+ hoverTemplate={"{{first}} {{last}}"}+ />+ </TooltipProvider>,+ );++ // Grab all rows and assert title attribute computed from template+ const rows = screen.getAllByRole("row");+ // The first row is header; subsequent rows correspond to data+ expect(rows[1]).toHaveAttribute("title", "Michael Scott");+ expect(rows[2]).toHaveAttribute("title", "Jim Halpert");+ });});diff --git a/frontend/src/components/data-table/cell-hover-template/feature.ts b/frontend/src/components/data-table/cell-hover-template/feature.tsnew file mode 100644index 0000000000..0beace674d--- /dev/null+++ b/frontend/src/components/data-table/cell-hover-template/feature.ts@@ -0,0 +1,14 @@+/* Copyright 2025 Marimo. All rights reserved. */+"use no memo";++import type { InitialTableState, TableFeature } from "@tanstack/react-table";+import type { CellHoverTemplateTableState } from "./types";++export const CellHoverTemplateFeature: TableFeature = {+ getInitialState: (state?: InitialTableState): CellHoverTemplateTableState => {+ return {+ ...state,+ cellHoverTemplate: null,+ };+ },+};diff --git a/frontend/src/components/data-table/cell-hover-template/types.ts b/frontend/src/components/data-table/cell-hover-template/types.tsnew file mode 100644index 0000000000..35363f8379--- /dev/null+++ b/frontend/src/components/data-table/cell-hover-template/types.ts@@ -0,0 +1,11 @@+/* Copyright 2025 Marimo. All rights reserved. */+/* eslint-disable @typescript-eslint/no-empty-interface */++export interface CellHoverTemplateTableState {+ cellHoverTemplate: string | null;+}++// Use declaration merging to add our new feature APIs+declare module "@tanstack/react-table" {+ interface TableState extends CellHoverTemplateTableState {}+}diff --git a/frontend/src/components/data-table/data-table.tsx b/frontend/src/components/data-table/data-table.tsxindex c7b7fc4466..01038eaa16 100644--- a/frontend/src/components/data-table/data-table.tsx+++ b/frontend/src/components/data-table/data-table.tsx@@ -25,6 +25,7 @@ import { Table } from "@/components/ui/table";import type { GetRowIds } from "@/plugins/impl/DataTablePlugin";import { cn } from "@/utils/cn";import type { PanelType } from "../editor/chrome/panels/context-aware-panel/context-aware-panel";+import { CellHoverTemplateFeature } from "./cell-hover-template/feature";import { CellSelectionFeature } from "./cell-selection/feature";import type { CellSelectionState } from "./cell-selection/types";import { CellStylingFeature } from "./cell-styling/feature";@@ -64,6 +65,7 @@ interface DataTableProps<TData> extends Partial<DownloadActionProps> {rowSelection?: RowSelectionState;cellSelection?: CellSelectionState;cellStyling?: CellStyleState | null;+ hoverTemplate?: string | null;onRowSelectionChange?: OnChangeFn<RowSelectionState>;onCellSelectionChange?: OnChangeFn<CellSelectionState>;getRowIds?: GetRowIds;@@ -104,6 +106,7 @@ const DataTableInternal = <TData,>({rowSelection,cellSelection,cellStyling,+ hoverTemplate,paginationState,setPaginationState,downloadAs,@@ -178,6 +181,7 @@ const DataTableInternal = <TData,>({ColumnFormattingFeature,CellSelectionFeature,CellStylingFeature,+ CellHoverTemplateFeature,CopyColumnFeature,FocusRowFeature,],@@ -236,10 +240,11 @@ const DataTableInternal = <TData,>({? {}: // No pagination, show all rows{ pagination: { pageIndex: 0, pageSize: data.length } }),- rowSelection,- cellSelection,+ rowSelection: rowSelection ?? {},+ cellSelection: cellSelection ?? [],cellStyling,columnPinning: columnPinning,+ cellHoverTemplate: hoverTemplate,},});diff --git a/frontend/src/components/data-table/renderers.tsx b/frontend/src/components/data-table/renderers.tsxindex 61b387045e..058e1d84ca 100644--- a/frontend/src/components/data-table/renderers.tsx+++ b/frontend/src/components/data-table/renderers.tsx@@ -93,6 +93,25 @@ export const DataTableBody = <TData,>({handleCellsKeyDown,} = useCellRangeSelection({ table });+ function applyHoverTemplate(+ template: string,+ cells: Array<Cell<TData, unknown>>,+ ): string {+ const variableRegex = /{{(\w+)}}/g;+ // Map column id -> stringified value+ const idToValue = new Map<string, string>();+ for (const c of cells) {+ const v = c.getValue();+ // Prefer empty string for nulls to keep tooltip clean+ const s = renderUnknownValue({ value: v, nullAsEmptyString: true });+ idToValue.set(c.column.id, s);+ }+ return template.replace(variableRegex, (_substr, varName: string) => {+ const val = idToValue.get(varName);+ return val !== undefined ? val : `{{${varName}}}`;+ });+ }+const renderCells = (cells: Array<Cell<TData, unknown>>) => {return cells.map((cell) => {const { className, style: pinningstyle } = getPinningStyles(cell.column);@@ -101,6 +120,7 @@ export const DataTableBody = <TData,>({cell.getUserStyling?.() || {},pinningstyle,);+return (<TableCelltabIndex={0}@@ -145,10 +165,18 @@ export const DataTableBody = <TData,>({const isRowViewedInPanel =rowViewerPanelOpen && viewedRowIdx === rowIndex;+ // Compute hover title once per row using this row's cells (visible or hidden)+ const hoverTemplate = table.getState().cellHoverTemplate || null;+ const rowCells = row.getAllCells();+ const rowTitle = hoverTemplate+ ? applyHoverTemplate(hoverTemplate, rowCells)+ : undefined;+return (<TableRowkey={row.id}data-state={row.getIsSelected() && "selected"}+ title={rowTitle}// These classes ensure that empty rows (nulls) still renderclassName={cn("border-t h-6",diff --git a/frontend/src/plugins/impl/DataTablePlugin.tsx b/frontend/src/plugins/impl/DataTablePlugin.tsxindex 583a0a862d..b12002561e 100644--- a/frontend/src/plugins/impl/DataTablePlugin.tsx+++ b/frontend/src/plugins/impl/DataTablePlugin.tsx@@ -254,6 +254,7 @@ export const DataTablePlugin = createPlugin<S>("marimo-table")maxColumns: z.union([z.number(), z.literal("all")]).default("all"),hasStableRowId: z.boolean().default(false),cellStyles: z.record(z.record(z.object({}).passthrough())).optional(),+ hoverTemplate: z.string().optional(),// Whether to load the data lazily.lazy: z.boolean().default(false),// If lazy, this will preload the first page of data@@ -385,6 +386,7 @@ interface DataTableProps<T> extends Data<T>, DataTableFunctions {// FiltersenableFilters?: boolean;cellStyles?: CellStyleState | null;+ hoverTemplate?: string | null;toggleDisplayHeader?: () => void;host: HTMLElement;cellId?: CellId | null;@@ -707,6 +709,7 @@ const DataTableComponent = ({totalColumns,get_row_ids,cellStyles,+ hoverTemplate,toggleDisplayHeader,calculate_top_k_rows,preview_column,@@ -904,6 +907,7 @@ const DataTableComponent = ({rowSelection={rowSelection}cellSelection={cellSelection}cellStyling={cellStyles}+ hoverTemplate={hoverTemplate}downloadAs={showDownload ? downloadAs : undefined}enableSearch={enableSearch}searchQuery={searchQuery}diff --git a/marimo/_plugins/ui/_impl/table.py b/marimo/_plugins/ui/_impl/table.pyindex 1bf062a935..1251b99f3a 100644--- a/marimo/_plugins/ui/_impl/table.py+++ b/marimo/_plugins/ui/_impl/table.py@@ -332,6 +332,7 @@ class table(on_change (Callable[[Union[List[JSONType], Dict[str, List[JSONType]], IntoDataFrame, List[TableCell]]], None], optional):Optional callback to run when this element's value changes.style_cell (Callable[[str, str, Any], Dict[str, Any]], optional): A function that takes the row id, column name and value and returns a dictionary of CSS styles.+ hover_template (str, optional): A template for the hover text of the table.max_columns (int, optional): Maximum number of columns to display. Defaults to theconfigured default_table_max_columns (50 by default). Set to None to show all columns.label (str, optional): A descriptive name for the table. Defaults to "".@@ -439,6 +440,7 @@ class table(]] = None,style_cell: Optional[Callable[[str, str, Any], dict[str, Any]]] = None,+ hover_template: Optional[str] = None,# The _internal_* arguments are for overriding and unit tests# table should take the value unconditionally_internal_column_charts_row_limit: Optional[int] = None,@@ -666,6 +668,7 @@ class table("wrapped-columns": wrapped_columns,"has-stable-row-id": self._has_stable_row_id,"cell-styles": search_result_styles,+ "hover-template": hover_template,"lazy": _internal_lazy,"preload": _internal_preload,},