用 LyteNyte Grid 构建强大透视表:度量值、总计与透视过滤实战

原创2026-10-16 22:25:051,677 阅读

用 LyteNyte Grid 构建强大透视表:度量值、总计与透视过滤实战

📊 LyteNyte Grid 是一款零依赖、约 40 KB 的 React 高性能数据网格。它的透视表(Pivoting)功能允许你动态生成透视列、配置度量值(Measures)、固定总计行,并对透视结果进行多维过滤——本文带你掌握这套完整的透视表实战技巧。

为什么你需要 LyteNyte Grid 透视表

传统数据表格只能"平铺"展示原始记录,而透视表能把数据旋转、分组、聚合:把"年龄组"变成列、把"国家"变成行、对"利润"求和——一张表就能看清业务全貌。

LyteNyte Grid 2.2 的透视能力是内置的声明式 API,无需引入任何聚合库:

LyteNyte Grid 2.2 官方发布:现代 UX 驱动的 React 数据网格

💡 透视功能属于 LyteNyte Grid Pro(由 1771 Technologies 支持),相关文档位于 pivoting-overview.mdx/pivoting-overview.mdx>)。

三步开启透视表模式:pivotMode + pivotModel

LyteNyte Grid 不内部保存透视状态,而是把透视管理委托给客户端数据源。开启透视只需三步:

  1. 在 useClientDataSource 中设置 pivotMode: true
  2. 提供 pivotModel 透视模型(列、行、度量值)
  3. 调用 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 项目中"透视表 + 数据网格"的一站式解决方案 🚀

登录后查看全文
lytenyte