0
Fork 0
mirror of https://github.com/TanStack/table.git synced 2026-11-18 18:55:54 +00:00
table/docs/framework/alpine/reference/functions/createTable.md
Kevin Van Cott 87c6bcc52a
feat(table-core): Further improve tree-shaking across features (#6626)
* feat(table-core): Further improve tree-shaking across features

Keep column ordering, column pinning, and row expanding code out of the
core bundle, route more cross-feature reads through feature stubs, and
stop allocating unused onAfterUpdate wrappers in production memos.

* refactor(table-core): register internal cross-feature fns as table APIs

Replace init*InstanceData function storage with @internal table APIs
registered via assignTableAPIs, route faceting through the
getCanGlobalFilter stub, and enforce feature boundaries with
import/no-restricted-paths. Regenerate reference docs and fix stale
docs config links.

---------
2026-10-12 09:51:47 -05:00

1.3 KiB

id title
createTable createTable
function createTable<TFeatures, TData>(tableOptions, selector?): AlpineTable<TFeatures, TData>;

Defined in: createTable.ts:46

Creates an Alpine-reactive table instance.

Reactivity is bridged through a single version counter that every proxied table read registers as a dependency, so by default ANY state change re-evaluates every Alpine binding that touches the table. Pass a selector to gate that: the counter then only bumps when the selected slice of state changes (shallow compare). Use () => ({}) to opt out of state-driven re-evaluation entirely and handle high-frequency state (e.g. column resizing) with explicit table.atoms.<slice>.subscribe() side effects. Options changes (e.g. new data) always re-evaluate.

Type Parameters

TFeatures

TFeatures extends TableFeatures

TData

TData extends RowData

Parameters

tableOptions

TableOptions<TFeatures, TData>

selector?

(state) => unknown

Returns

AlpineTable<TFeatures, TData>

Example

const table = createTable(options, (state) => ({ sorting: state.sorting }))