用途:当任务涉及哪些列渲染、列出现位置、列宽或吸附(sticky)行为时使用本技能。
主要范围:列可见性;列尺寸与调整模式(columnResizeMode);列固定与吸附布局;列排序;基于拖拽的列移动;固定、排序与分组布局模式之间的优先级。
路由提示:出现“hide/show columns”“getVisibleLeafColumns”“must-show column”“resizable headers”“columnResizeMode”“performant resizing”“sticky pinned action column”“left/right pinned columns”“reorder columns”“column DnD”“@dnd-kit”时指向本技能;行分组、展开、选择或行固定属于 tanstack-table-grouping-and-row-features;自定义单元格渲染或表头分组属于 tanstack-table-columns-and-rendering。
使用流程:先读 references/column-layout-features.md;确认问题是可见性、尺寸、固定、排序还是它们之间的交互;在假定隐藏列已消失前,先用可见性感知的渲染 API;调试排序行为前先检查固定与分组的优先级。
必要用法要点:涉及可见性时使用 table.getVisibleLeafColumns() 与 row.getVisibleCells(),不要用会忽略隐藏状态的 getAll* API;React 中 columnResizeMode: "onEnd" 更稳妥,"onChange" 需要更细致的优化;列固定优先级顺序为固定优先,其次是手动列顺序,最后是分组重排/移除模式;columnOrder 只影响未固定的中间部分;吸附固定属于应用层 CSS,通常用 position: sticky 配合 column.getStart("left") 或 column.getAfter("right") 的偏移;React 18+ 的列排序官方文档建议优先使用 @dnd-kit/core 而非 react-dnd。
限制与快照:资料未提供具体收费标准与更多平台细节。快照日期 2026-03-24,稳定包快照 @tanstack/react-table@8.21.3,稳定文档分支 v8。