该技能构建于 core、table-features 与 client-vs-server 之上。分组负责生成行结构,渲染层负责决定分组单元格的 UI。若分组行还需要计算数值,应另行加载聚合(aggregation)技能。
用途:为 TanStack Table 实现行分组,处理分组行、占位单元格和分组交互。
主要能力:提供 columnGroupingFeature、groupedRowModel、groupedColumnMode 与 manualGrouping 等选项;支持客户端与服务端分组模式。
必要用法:注册特性时 groupedRowModel 的槽位需要同时注册 columnGroupingFeature。示例:tableFeatures({ columnGroupingFeature, groupedRowModel: createGroupedRowModel() })。渲染时可依据 cell.getIsGrouped()、cell.getIsPlaceholder() 判断单元格模式,分别渲染分组单元格、占位单元格或普通值。
限制与常见错误:不要把渲染行直接当作底层数据记录,需从分组行递归统计后代叶子行;占位单元格不代表普通叶子值,不应直接渲染 getValue()。API 细节可查看 node_modules/@tanstack/table-core/dist/features/column-grouping/ 目录。