SuperAPI AI 工具集

tanstack-table-core-column-ordering

通用与其它

查看项目

更新于 10-16 00:02

技能介绍

用途:在 TanStack Table v9 中通过 columnOrder 状态控制未固定叶子列的排列顺序,其他插件仍可决定最终视觉区域。

主要能力:以叶子列 ID 作为排序身份,替换整个数组来更新顺序;与固定列、可见性、分组模式等特性协同工作。

用法:注册 columnOrderingFeature,设置 initialState 的 columnOrder 数组;拖拽排序时用列 ID 过滤并插入,再调用 table.setColumnOrder(next)。渲染时不要直接渲染 columnOrder,而应渲染 table.getAllLeafColumns();若同时注册 columnVisibilityFeature,则渲染 table.getVisibleLeafColumns()。

限制与注意:columnOrder 不是最终顺序,固定区域和分组模式会在基础排序之后生效;不要用表头标签作为身份,表头可能重复或变化;受控状态下不要原地修改数组,需传入新数组引用。API 细节可查看 node_modules/@tanstack/table-core/dist/features/column-ordering/。