Skip to content

TableProps

Defined in: react/components/data/table.tsx:7

Props for Table.

Row = any

optional className?: string

Defined in: react/components/types.ts:24

Space-separated class names (currently advisory; no CSS cascade).

ComponentProps.className


columns: TableColumn<Row>[]

Defined in: react/components/data/table.tsx:20

Column definitions (key, header, width, optional render).


optional data?: Row[]

Defined in: react/components/data/table.tsx:9

Source rows. Only the visible window is ever rendered (virtualized). Ignored when groups is set.


optional disabled?: boolean

Defined in: react/components/types.ts:52

Marks the widget (and its descendants) as inert: not focusable, ignores key/mouse input, and interactive controls render in a muted style. A disabled container propagates to every control inside it.

ComponentProps.disabled


optional focusable?: boolean

Defined in: react/components/types.ts:40

Allow this widget to take keyboard focus.

ComponentProps.focusable


optional focusOnClick?: boolean

Defined in: react/components/types.ts:46

When a click lands on this container (its padding, border, or a non-focusable child), move focus to its first focusable descendant — so clicking a Form/Panel/Box hands focus to its first field. Off by default.

ComponentProps.focusOnClick


optional groups?: RowGroup<Row>[]

Defined in: react/components/data/table.tsx:16

Grouped mode: each group renders a non-interactive title row (spanning all columns) followed by its rows; clicking a title collapses/expands it. When set, sort and rich (render) cells are ignored — grouped tables are text-only.


optional headerStyle?: TableTextStyle

Defined in: react/components/data/table.tsx:26

Header formatting. Bold by default; pass { bold: false } for a plain header.


optional hoverInterest?: boolean

Defined in: react/components/types.ts:66

Opt-in hint that this widget cares about passive hover movement.

ComponentProps.hoverInterest


optional id?: string

Defined in: react/components/types.ts:22

Stable identifier, handy for tests and lookups.

ComponentProps.id


optional label?: string

Defined in: react/components/types.ts:36

Structural/accessible label (also the tab title inside TabContainer).

ComponentProps.label


optional onActivate?: (row, viewIndex) => void

Defined in: react/components/data/table.tsx:34

Row activated — Enter or double-click.

Row

number

void


optional onClick?: (ev) => void

Defined in: react/components/types.ts:54

Pointer click.

any

void

ComponentProps.onClick


optional onDragEnd?: (x, y, moved) => void

Defined in: react/components/types.ts:72

Drag released; moved is false for a tap with no movement.

number

number

boolean

void

ComponentProps.onDragEnd


optional onDragMove?: (x, y) => void

Defined in: react/components/types.ts:70

Pointer moved while dragging from this widget.

number

number

void

ComponentProps.onDragMove


optional onDragStart?: (x, y) => void

Defined in: react/components/types.ts:68

Pointer-drag lifecycle; moved is false for a tap with no movement.

number

number

void

ComponentProps.onDragStart


optional onKey?: (ev) => void

Defined in: react/components/types.ts:58

Key event while focused; set ev.handled to consume it.

any

void

ComponentProps.onKey


optional onMouseDown?: (ev) => void

Defined in: react/components/types.ts:56

Pointer pressed (any button); the event carries button and x/y.

any

void

ComponentProps.onMouseDown


optional onMouseEnter?: (ev) => void

Defined in: react/components/types.ts:62

Pointer entered this widget’s region.

any

void

ComponentProps.onMouseEnter


optional onMouseLeave?: (ev) => void

Defined in: react/components/types.ts:64

Pointer left this widget’s region.

any

void

ComponentProps.onMouseLeave


optional onScroll?: (ev) => void

Defined in: react/components/types.ts:60

Wheel / scroll event.

any

void

ComponentProps.onScroll


optional onSelect?: (row, viewIndex) => void

Defined in: react/components/data/table.tsx:32

Selection changed (arrow navigation or single click).

Row

number

void


optional onSortChange?: (sort) => void

Defined in: react/components/data/table.tsx:36

Sort changed (column header clicked); makes sort controlled.

SortState | null

void


optional onToggleGroup?: (id, collapsed) => void

Defined in: react/components/data/table.tsx:18

A group was collapsed or expanded (grouped mode).

string

boolean

void


optional ref?: Ref<Widget>

Defined in: react/components/types.ts:30

Captures the underlying widget instance (React 19 ref-as-prop). Defaults to the base Widget; narrow it with a cast when you need a subclass field, e.g. ref={inputRef as React.Ref<InputWidget>}.

ComponentProps.ref


optional rowHeight?: number

Defined in: react/components/data/table.tsx:22

Height of each row in cells (default 1).


optional selectedIndex?: number

Defined in: react/components/data/table.tsx:28

Selected row in display order, or -1.


optional showHeader?: boolean

Defined in: react/components/data/table.tsx:24

Show the header row (default true).


optional sort?: SortState | null

Defined in: react/components/data/table.tsx:30

Active sort. Controlled when onSortChange is provided.


optional style?: WidgetStyles

Defined in: react/components/types.ts:32

Inline styles for this widget — see the Styling guide.

ComponentProps.style


optional theme?: string

Defined in: react/components/types.ts:34

Re-theme this subtree; descendants resolve $tokens against it.

ComponentProps.theme