column-ordering
Control TanStack Table v9 leaf columnOrder with stable IDs while accounting for pinning regions, visibility, and groupedColumnMode precedence. Load for drag-and-drop columns or rendered order that differs from state.
How do I install this agent skill?
npx skills add https://github.com/tanstack/table --skill column-orderingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides instructions for managing column ordering within TanStack Table v9. It covers proper state updates, the use of stable column IDs, and common developer pitfalls. The skill only references official library components and does not perform any dangerous operations.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
This skill builds on core and table-features. columnOrder orders unpinned leaf IDs; other plugins can still determine the final visual regions.
Setup
import { columnOrderingFeature, tableFeatures } from '@tanstack/table-core'
export const features = tableFeatures({ columnOrderingFeature })
export const initialState = { columnOrder: ['name', 'age', 'actions'] }
Core Patterns
const next = columnOrder.filter((id) => id !== activeId)
next.splice(next.indexOf(overId), 0, activeId)
table.setColumnOrder(next)
Use column IDs as drag identities and replace the array.
Common Mistakes
[HIGH] Assuming state is final order
Wrong: renderIds(columnOrder)
Correct: renderColumns(table.getAllLeafColumns())
Pinning regions and grouping mode apply after base ordering. If
columnVisibilityFeature is also registered, render
table.getVisibleLeafColumns() to apply visibility too.
Source: docs/framework/react/guide/column-ordering.md#what-affects-column-order
[HIGH] Using labels as identities
Wrong: const activeId = column.columnDef.header as string
Correct: const activeId = column.id
Headers can collide or change; ordering state stores stable leaf column IDs.
Source: packages/table-core/src/features/column-ordering/columnOrderingFeature.types.ts
[HIGH] Mutating controlled state in place
Wrong: columnOrder.splice(0, 1); table.setColumnOrder(columnOrder)
Correct: table.setColumnOrder(columnOrder.slice(1))
Reactive owners commonly require a new array reference.
Source: examples/react/column-dnd/src/main.tsx
API Discovery
Inspect node_modules/@tanstack/table-core/dist/features/column-ordering/; combine with pinning/visibility skills when those plugins are registered.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tanstack/table/column-ordering">View column-ordering on skillZs</a>