SuperAPI AI 工具集

tanstack-table-core-grouping

数据与分析

查看项目

更新于 10-16 05:44

技能介绍

用途:在 TanStack Table Core 中实现行分组,构建分组后的行结构,并由渲染层自行决定分组单元格 UI。它建立在 core、table-features 与 client-vs-server 之上。若分组行还需计算值,应另行加载聚合技能。

主要能力与用法:注册 columnGroupingFeature 与 createGroupedRowModel(),通过 tableFeatures 挂载:columnGroupingFeature、groupedRowModel: createGroupedRowModel()。可用 groupedColumnMode: 'reorder' 控制分组列模式;用 cell.getIsGrouped()、cell.getIsPlaceholder() 判断渲染模式,分别对应 grouped、placeholder、value。

常见限制与易错点:仅注册 groupedRowModel 而不注册 columnGroupingFeature 会出错,分组行模型槽依赖该特性。不要把渲染出的行当作底层记录:getRowModel().rows 是渲染顺序,原始数据集计数应由数据拥有方提供;统计叶子行应从某个分组行的 subRows 递归计算。placeholder 单元格不代表普通叶子值,不应统一按 cell.getValue() 渲染,未启用聚合时分组行只渲染其分组单元格。

其它:manualGrouping 及更多 API 细节可查看 node_modules/@tanstack/table-core/dist/features/column-grouping/。具体平台、收费与版本限制暂未提供。