| autoRowHeight | false | boolean |
Measures each rendered row instead of trusting rowHeight, so rows grow with their content (wrapping cells, custom templates). rowHeight stays the estimate for rows that have not been rendered yet. Requires virtualization. |
| cellNavigation | false | boolean |
APG grid keyboard navigation — role="grid", a roving-tabindex active cell, and arrow-key movement across header and data cells. |
| cellSelection | false | boolean |
Spreadsheet-style cell ranges — shift-click, drag and shift+arrows, with Ctrl/Cmd+C copying the range as TSV and Ctrl/Cmd+A selecting everything. Implies cellNavigation. |
| columnFilters | false | boolean |
Renders a filter row in the header with an input per filterable column. |
| columnMenu | false | boolean, DataGridColumnMenuBuilder |
Adds a per-column header menu — true builds it from the enabled features (sort/pin/move/hide); a builder ({ column, defaultActions }) => actions returns the final item list. |
| columnMenuIcon | - | TemplateRef<unknown>, undefined |
Custom column menu button icon (TemplateRef) replacing the default one. |
| columnOrder | false | boolean, ColumnOrderState |
Enables drag-and-drop column reordering; an array sets the initial order. |
| columnPinning | false | boolean, Partial<ColumnPinningState> |
Freezes columns (by key) to the start/end edge with sticky positioning; true enables the feature with no initial pins. |
| columns | - | DataGridColumn[] |
Column definitions. |
| columnSizing | false | boolean, DataGridColumnSizingOptions |
Enables column resize handles; mode controls whether widths update while dragging ('onChange', the default) or on release ('onEnd'). |
| columnVisibility | false | boolean, ColumnVisibilityState |
Enables hiding/showing columns via column.toggleVisibility(); an object sets the initial visibility. |
| dataProvider | - | object, undefined |
Server-side mode: the grid requests data on every sorting/filter/page change; implies pagination. |
| editing | false | boolean |
Inline cell editing on Enter/F2/double-click for columns opting in via editable or a cDataGridCellEditor template; implies cellNavigation. |
| empty | 'No items found' | string |
Content shown when no rows match. |
| features | dataGridFeatures | TableFeatures |
The registered TanStack feature set — pass dataGridLiteFeatures (or a custom tableFeatures({...}) set) so the app bundle only carries the features it uses; defaults to the full dataGridFeatures. Static per table instance — read once at table creation, changing it later has no effect. |
| filterIcon | - | TemplateRef<unknown>, undefined |
Icon for the per-column filter button. |
| globalFilter | false | boolean |
Renders a search input above the grid that filters across all columns. |
| hideColumnIcon | - | TemplateRef<unknown>, undefined |
Custom hide-column menu action icon (TemplateRef) replacing the default one. |
| history | false | boolean |
Undo/redo history of edit commits — Ctrl/Cmd+Z and Ctrl+Shift+Z/Ctrl+Y plus toolbar buttons; requires editing. |
| infiniteScroll | false | boolean, DataGridInfiniteScrollOptions |
Appends each loaded page to the rows already in view instead of replacing them; requires dataProvider and virtualization, cannot be combined with pagination. |
| itemKey | - | object, undefined |
Stable row id — required for selection to survive sorting and filtering. |
| items | [] | DataGridItem[] |
Row data. |
| labels | {} | Partial<DataGridLabels> |
UI strings (i18n), merged over the defaults; supports {token} interpolation. |
| moveEndIcon | - | TemplateRef<unknown>, undefined |
Custom move-right menu action icon (TemplateRef) replacing the default one. |
| moveStartIcon | - | TemplateRef<unknown>, undefined |
Custom move-left menu action icon (TemplateRef) replacing the default one. |
| overscan | 10 | number |
Extra rows rendered above and below the visible window. |
Pagination mode — mutually exclusive with virtualization. |
| pinEndIcon | - | TemplateRef<unknown>, undefined |
Custom pin-right menu action icon (TemplateRef) replacing the default one. |
| pinStartIcon | - | TemplateRef<unknown>, undefined |
Custom pin-left menu action icon (TemplateRef) replacing the default one. |
| printTitle | - | string, undefined |
Heading printed above the table when the print action runs; omitted when unset. |
| rowHandleIcon | - | TemplateRef<unknown>, undefined |
Custom row drag-handle icon (TemplateRef) replacing the default grip. |
| rowHeight | 44 | number |
Estimated row height in px used by the virtualizer. |
| rowOrder | false | boolean |
Adds a drag handle per row for reordering; the grid emits rowOrderChange with the reordered array instead of mutating items. |
| rowSelection | false | boolean, DataGridRowSelectionOptions |
Checkbox selection with select-all and shift+click ranges. |
| sortAscendingIcon | - | TemplateRef<unknown>, undefined |
Custom ascending sort indicator icon (TemplateRef) replacing the default one. |
| sortDescendingIcon | - | TemplateRef<unknown>, undefined |
Custom descending sort indicator icon (TemplateRef) replacing the default one. |
| sorterVisibility | - | 'always', 'hover', undefined |
Controls when the neutral (unsorted) sort icon is shown on sortable columns: 'always' keeps it visible, 'hover' reveals it on header hover/focus. Omit to hide it until the column is sorted. |
| sorting | true | boolean, DataGridSortingOptions |
Column sorting; shift+click adds columns to the sort. |
| sortNeutralIcon | - | TemplateRef<unknown>, undefined |
Custom unsorted sort indicator icon (TemplateRef) replacing the default one. |
| stateKey | - | string, undefined |
Persists the grid state (sorting, filters, order, sizing, visibility, pinning, selection, page) to localStorage under this key — autosaved on every change and restored on init. |
| toolbar | false | boolean, DataGridToolbarOptions |
Adds a toolbar above the grid — true enables every action whose feature is on (columns needs columnVisibility, export, search); an object picks each individually. |
| toolbarColumnsIcon | - | TemplateRef<unknown>, undefined |
Custom toolbar column-chooser button icon (TemplateRef) replacing the default one. |
| toolbarExportIcon | - | TemplateRef<unknown>, undefined |
Custom toolbar export button icon (TemplateRef) replacing the default one. |
| toolbarPrintIcon | - | TemplateRef<unknown>, undefined |
Custom toolbar print button icon (TemplateRef) replacing the default one. |
| toolbarRedoIcon | - | TemplateRef<unknown>, undefined |
Custom toolbar redo button icon (TemplateRef) replacing the default one. |
| toolbarUndoIcon | - | TemplateRef<unknown>, undefined |
Custom toolbar undo button icon (TemplateRef) replacing the default one. |
| unpinIcon | - | TemplateRef<unknown>, undefined |
Custom unpin menu action icon (TemplateRef) replacing the default one. |
| virtualization | true | boolean |
Windowed rendering for large datasets. |