TableFeature

Defined in: types/TableFeatures.ts:319

Lifecycle hooks and defaults contributed by a table feature.

Feature objects are registered in the table's features option. They can contribute default state/options, default column definitions, table APIs, shared prototype APIs for rows/columns/headers/cells, and per-instance data for tables, columns, rows, headers, header groups, and cells.

Properties

assignCellPrototype?

optional assignCellPrototype?: <TFeatures, TData>(prototype, table) => void;

Defined in: types/TableFeatures.ts:328

Adds feature methods to the shared cell prototype for a table.

This runs lazily the first time a cell is constructed for a table. Methods assigned here are shared by every cell instance created by that table, so this hook should be used for APIs and memoized methods rather than per-cell mutable data.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

prototype

Record<string, any>

table

Table_Internal<TFeatures, TData>

Returns

void

assignColumnPrototype?

optional assignColumnPrototype?: <TFeatures, TData>(prototype, table) => void;

Defined in: types/TableFeatures.ts:343

Adds feature methods to the shared column prototype for a table.

This runs lazily the first time a column is constructed for a table. Methods assigned here are shared by every column instance created by that table, so this hook should be used for APIs and memoized methods rather than per-column mutable data.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

prototype

Record<string, any>

table

Table_Internal<TFeatures, TData>

Returns

void

assignHeaderPrototype?

optional assignHeaderPrototype?: <TFeatures, TData>(prototype, table) => void;

Defined in: types/TableFeatures.ts:358

Adds feature methods to the shared header prototype for a table.

This runs lazily the first time a header is constructed for a table. Methods assigned here are shared by every header instance created by that table, so this hook should be used for APIs and memoized methods rather than per-header mutable data.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

prototype

Record<string, any>

table

Table_Internal<TFeatures, TData>

Returns

void

assignRowPrototype?

optional assignRowPrototype?: <TFeatures, TData>(prototype, table) => void;

Defined in: types/TableFeatures.ts:373

Adds feature methods to the shared row prototype for a table.

This runs lazily the first time a row is constructed for a table. Methods assigned here are shared by every row instance created by that table, so this hook should be used for APIs and memoized methods rather than per-row mutable data.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

prototype

Record<string, any>

table

Table_Internal<TFeatures, TData>

Returns

void

constructTableAPIs?

optional constructTableAPIs?: <TFeatures, TData>(table) => void;

Defined in: types/TableFeatures.ts:386

Adds feature APIs directly to the table instance.

The table is a singleton, unlike rows, columns, headers, and cells, so table APIs are assigned directly instead of through a shared prototype. This hook is exclusively for assigning table methods. It runs after options, state atoms, and the store have been created and after every feature's initTableInstanceData hook has completed.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

table

Table_Internal<TFeatures, TData>

Returns

void

getDefaultColumnDef?

optional getDefaultColumnDef?: <TFeatures, TData, TValue>() => ColumnDefBase_All<TFeatures, TData, TValue>;

Defined in: types/TableFeatures.ts:396

Returns default column definition options contributed by this feature.

These defaults are merged into the table's default column definition before options.defaultColumn and before each user-supplied column definition is resolved, so users can override values supplied here.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

TValue

TValue extends unknown = unknown

Returns

ColumnDefBase_All<TFeatures, TData, TValue>

getDefaultTableOptions?

optional getDefaultTableOptions?: <TFeatures, TData>(table) => Partial<TableOptions_All<TFeatures, TData>>;

Defined in: types/TableFeatures.ts:409

Returns default table options contributed by this feature.

This runs while table options are being resolved. Use it for option defaults such as feature enablement flags and default state-updater callbacks. User-supplied table options take precedence over values returned here.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

table

Table_Internal<TFeatures, TData>

Returns

Partial<TableOptions_All<TFeatures, TData>>

getInitialState?

optional getInitialState?: (initialState) => TableState_All;

Defined in: types/TableFeatures.ts:423

Returns this feature's initial table state.

The incoming initialState contains state accumulated from earlier features and user-provided initial state. Return a complete state object for this feature, preserving initialState so user-provided values can override feature defaults.

Parameters

initialState

Partial<TableState_All>

Returns

TableState_All

initCellInstanceData?

optional initCellInstanceData?: <TFeatures, TData, TValue>(cell) => void;

Defined in: types/TableFeatures.ts:452

Initializes instance-specific data on each cell.

This runs for every constructed cell after core cell fields such as id, column, and row have been assigned. Cells are constructed lazily on first access per row/column pair and cached, so this runs once per cell instance. Use this for per-cell mutable data, caches, or annotations. Shared methods should be assigned via assignCellPrototype instead.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

TValue

TValue extends unknown = unknown

Parameters

cell

Cell<TFeatures, TData, TValue>

Returns

void

initColumnInstanceData?

optional initColumnInstanceData?: <TFeatures, TData, TValue>(column) => void;

Defined in: types/TableFeatures.ts:467

Initializes instance-specific data on each column.

This runs for every constructed column after core column fields such as id, depth, parent, columnDef, and columns have been assigned. Use this for per-column mutable data, caches, or annotations. Shared methods should be assigned via assignColumnPrototype instead.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

TValue

TValue extends unknown = unknown

Parameters

column

Column<TFeatures, TData, TValue>

Returns

void

initHeaderGroupInstanceData?

optional initHeaderGroupInstanceData?: <TFeatures, TData>(headerGroup) => void;

Defined in: types/TableFeatures.ts:483

Initializes instance-specific data on each header group.

This runs for every constructed header group after depth, id, and the fully populated headers array have been assigned. Header groups have no shared prototype, so this is their only per-instance extension point. Header groups are reconstructed whenever they recompute (e.g. column visibility, order, or pinning changes), so this reruns on every rebuild.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

headerGroup

HeaderGroup<TFeatures, TData>

Returns

void

initHeaderInstanceData?

optional initHeaderInstanceData?: <TFeatures, TData, TValue>(header) => void;

Defined in: types/TableFeatures.ts:500

Initializes instance-specific data on each header.

This runs for every constructed header after core header fields such as id, column, depth, index, and isPlaceholder have been assigned, but before subHeaders are populated and before headerGroup is linked. Headers are reconstructed on every header group rebuild, so this reruns on every rebuild. Use this for per-header mutable data, caches, or annotations. Shared methods should be assigned via assignHeaderPrototype instead.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

TValue

TValue extends unknown = unknown

Parameters

header

Header<TFeatures, TData, TValue>

Returns

void

initRowInstanceData?

optional initRowInstanceData?: <TFeatures, TData>(row) => void;

Defined in: types/TableFeatures.ts:515

Initializes instance-specific data on each row.

This runs for every constructed row after core row fields such as id, index, depth, original, parentId, and subRows have been assigned. Use this for per-row mutable data, caches, or annotations. Shared methods should be assigned via assignRowPrototype instead.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

row

Row<TFeatures, TData>

Returns

void

initTableInstanceData?

optional initTableInstanceData?: <TFeatures, TData>(table) => void;

Defined in: types/TableFeatures.ts:437

Initializes mutable, non-reactive data owned by this feature on the table instance.

This runs once during table construction after options, state atoms, and the store are available. Features are processed in a single pass in registration order, with each feature's instance data initialized just before its own constructTableAPIs hook, so this hook may rely on data and APIs of features registered earlier. Use constructTableAPIs exclusively for assigning table methods. Table resets do not rerun this hook; use resetTableInstanceData to clear transient instance data instead.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

table

Table_Internal<TFeatures, TData>

Returns

void

resetTableInstanceData?

optional resetTableInstanceData?: <TFeatures, TData>(table) => void;

Defined in: types/TableFeatures.ts:528

Resets mutable, non-reactive table-instance data owned by this feature.

This runs after internally owned state atoms have been restored to table.initialState by table.reset(). It is intended for transient feature data, not table state slices or externally controlled state.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

table

Table_Internal<TFeatures, TData>

Returns

void