用 LyteNyte Grid 构建强大透视表:度量值、总计与透视过滤实战
用 LyteNyte Grid 构建强大透视表:度量值、总计与透视过滤实战
📊 LyteNyte Grid 是一款零依赖、约 40 KB 的 React 高性能数据网格。它的透视表(Pivoting)功能允许你动态生成透视列、配置度量值(Measures)、固定总计行,并对透视结果进行多维过滤——本文带你掌握这套完整的透视表实战技巧。
为什么你需要 LyteNyte Grid 透视表
传统数据表格只能"平铺"展示原始记录,而透视表能把数据旋转、分组、聚合:把"年龄组"变成列、把"国家"变成行、对"利润"求和——一张表就能看清业务全貌。
LyteNyte Grid 2.2 的透视能力是内置的声明式 API,无需引入任何聚合库:
💡 透视功能属于 LyteNyte Grid Pro(由 1771 Technologies 支持),相关文档位于 pivoting-overview.mdx/pivoting-overview.mdx>)。
三步开启透视表模式:pivotMode + pivotModel
LyteNyte Grid 不内部保存透视状态,而是把透视管理委托给客户端数据源。开启透视只需三步:
- 在
useClientDataSource中设置pivotMode: true - 提供
pivotModel透视模型(列、行、度量值) - 调用
usePivotProps钩子,把返回的 props 展开给<Grid />
const ds = useClientDataSource<GridSpec>({
data: salesData,
pivotMode: true,
pivotModel: {
columns: [{ id: "ageGroup" }], // 列透视:年龄组
rows: [{ id: "country" }], // 行透视:国家
measures: [{ dim: profitColumn, fn: "sum" }], // 度量值:利润求和
},
});
const pivotProps = ds.usePivotProps();
return <Grid {...pivotProps} />;
三者组合出的视图效果各不相同:
| 提供的属性 | 透视结果 |
|---|---|
仅 measures |
全部行聚合成一行总计 |
measures + columns |
每个动态透视列做聚合 |
measures + rows |
每个行分组做聚合 |
| 三者齐全 | 行分组 × 透视列的完整透视表 |
完整可运行的参考实现见 pivot-full demo/demos/pivot-full/demo.tsx>),下面是官方文档演示中配合 Pill Manager 管理透视配置的界面,可以看到 Measures、Row Pivots、Column Pivots 三组"药丸"控件:
LyteNyte Grid 透视表界面:度量值、行透视与列透视药丸管理器/version-2.png)
度量值实战:sum、avg 与同一列多度量
度量值(Measures) 定义了"如何把一组行汇总成一个数"。每个 measure 由两部分组成:
dim:列定义模板,决定生成的透视列长什么样(标题、宽度、单元格渲染器)fn:聚合函数,可以是预定义名称(如"sum"),也可以是内联自定义函数
通过 aggregateFns 注册聚合函数即可:
const aggSum: Grid.T.Aggregator<GridSpec["data"]> = (field, data) => {
const values = data.map((x) => computeField<number>(field, x));
return sum(values);
};
// 在数据源中注册
aggregateFns: { sum: aggSum, avg: aggAvg },
参考 pivot-measures demo/demos/pivot-measures/demo.tsx>)。
同一列应用多个聚合函数
⚠️ 注意:度量值会成倍放大列数——透视生成 20 列时,2 个度量值就是 40 列,3 个就是 60 列。
对同一列(如 Profit)同时应用 sum 和 avg 时,必须为每个 measure 提供唯一 id,LyteNyte Grid 靠 id 区分它们:
measures: [
{ dim: { ...profitColumn, id: "Profit (sum)", name: "Profit (sum)" }, fn: "sum" },
{ dim: { ...profitColumn, id: "Profit (avg)", name: "Profit (avg)" }, fn: "avg" },
]
更多用法见 pivot-measures-multiple demo/demos/pivot-measures-multiple/demo.tsx>)。
总计行一键固定:pivotGrandTotals 属性
想让整张透视表有一行总计(Grand Totals)?只需一个属性:
const ds = useClientDataSource<GridSpec>({
data: salesData,
pivotMode: true,
pivotGrandTotals: "bottom", // "top" 置顶 | "bottom" 置底
pivotModel: { /* ... */ },
});
"top":总计行固定在视口顶部,适合"结论先行"的报表"bottom":总计行固定在视口底部,贴近阅读习惯
总计行本质是一个聚合行(aggregation row),它汇总当前视口中的所有行,并且使用 pivotModel 里定义的度量值来计算。参考 pivot-grand-totals demo/demos/pivot-grand-totals/demo.tsx>)。
透视过滤实战:三种过滤方式对比
透视后的数据都是分组行,因此过滤方式也分三层,可按需组合:
1️⃣ Having 过滤(filter 属性)——过滤聚合后的行
pivotModel.filter 接受 HavingFilterFn 函数数组,作用于特定深度的分组行。典型用法:点击列头漏斗图标,为某个透视列设置"利润 > 10000"这类条件。
pivotModel: {
filter: filterFn, // 根据 UI 过滤模型生成的 HavingFilterFn
// ...
}
参考 pivot-filtering demo/demos/pivot-filtering/demo.tsx>)(其中实现了 equals / greater_than / less_than 等数字比较操作符)。
2️⃣ 透视前过滤(pivotApplyExistingFilter)
默认情况下,透视会忽略常规行过滤,用全部行生成透视列。设置 pivotApplyExistingFilter 后,网格会先过滤行、再透视——例如只看 United States 和 Germany 的数据再透视。
参考 pivot-existing-filters demo/demos/pivot-existing-filters/demo.tsx>)。
3️⃣ 标签过滤(rowLabelFilter / colLabelFilter)——按维度值筛选
透视会生成行/列标签,你可以按标签包含或排除特定维度值。过滤器按数组下标对应层级深度:
pivotModel: {
colLabelFilter: [(s) => s !== "Under 25"], // 排除 Youth 列
rowLabelFilter: [(s) => s === "Germany" || s === "United States"], // 只保留两个国家
// ...
}
参考 pivot-label-filters demo/demos/pivot-label-filters/demo.tsx>)。
进阶技巧:动态加工透视列与行列互换
pivotColumnProcessor:透视列由网格动态生成,可用该处理器在渲染前任意修改——重排序、删除、改属性。官方示例用它移除了自动生成的 Total 列:
pivotColumnProcessor: (columns) =>
columns.filter((x) => !x.id.includes("total")),
- 行与列可互换:行透视和列透视定义是完全对等的,交换两者即可"旋转"整张透视表(Pill Manager 里的 SWAP 按钮就是干这个的)。详见 pivot-rows demo/demos/pivot-rows/demo.tsx>)。
- 多层列透视:添加多个列透视会形成列分组层级,列数会指数级增长,请在应用侧自行设限;可通过
api.columnToggleGroup折叠分组。
相关模块速查
| 功能 | 文档 / 源码位置 |
|---|---|
| 透视总览 | pivoting-overview.mdx/pivoting-overview.mdx>) |
| 度量值 | pivoting-measures.mdx/pivoting-measures.mdx>) |
| 总计行 | pivoting-grand-totals.mdx/pivoting-grand-totals.mdx>) |
| 透视过滤 | pivoting-filtering.mdx/pivoting-filtering.mdx>) |
| 行列透视 | pivoting-columns-and-rows.mdx/pivoting-columns-and-rows.mdx>) |
| 完整示例 | pivot-full demo/demos/pivot-full/demo.tsx>) |
| 客户端数据源实现 | packages/commercial-lytenyte-pro/src/data-source-client/ |
| 共享类型定义 | packages/lytenyte-shared/src/ |
总结
LyteNyte Grid 的透视表功能用一套极简的声明式 API 覆盖了企业级报表的核心需求:
- ✅
pivotModel:columns/rows/measures三属性构建完整透视视图 - ✅ 度量值:支持预定义与自定义聚合函数,同一列可挂多个不同函数
- ✅
pivotGrandTotals:一行代码固定总计行,顶部/底部任选 - ✅ 三层过滤:Having 过滤、透视前过滤、标签过滤,精细控制透视输出
配合零依赖的轻量内核与 150+ 企业级特性,它足以成为你 React 项目中"透视表 + 数据网格"的一站式解决方案 🚀
