Syncfusion Angular Pivot Grid 是一个用于创建交互式透视表、聚合多维数据并执行高级分析操作的数据可视化与分析组件。本技能用于当用户咨询如何在 Angular 中构建或定制 Syncfusion PivotView 透视表时提供指导。
【用途】 该技能适用于需要创建和配置多维数据透视表、从 OLAP 或关系型数据源绑定数据、对数据进行聚合与分组、创建计算字段、启用钻取与穿透、集成透视图表、应用自定义格式与条件样式、优化大数据集性能、将透视数据导出为 Excel 或 PDF、持久化与恢复透视表状态,以及通过字段列表、分组栏和工具栏定制 UI 等场景。
【主要能力与文档结构】 技能内容按主题组织为多个参考文档:
- 快速入门(references/getting-started.md):涵盖安装与包设置(Angular 21 独立架构)、基础透视网格实现、主题包(使用整合后的 @syncfusion/ej2-{theme}-theme 包,如 ej2-material3-theme,并通过单一 styles/pivotview/index.css 导入)、CSS 导入与主题配置、组件初始化(PivotViewModule、bootstrapApplication)。
- 聚合(references/aggregation.md):支持 Sum、Avg、Count、Min、Max、Product、Median、DistinctCount 等聚合函数;DifferenceFrom、PercentageOfDifferenceFrom、PercentageOfParentTotal 等高级聚合;以及 PercentageOfParentColumnTotal、PercentageOfParentRowTotal、RunningTotals、PercentageOfRunningTotals 等。
- 分组(references/grouping.md):通过 allowGrouping: true 并注入 GroupingService 启用;支持数字分组(rangeInterval、startingAt、endingAt)、日期分组(年/季/月/日/时/分/秒)、自定义分组及取消分组。
- 计算字段(references/calculated-field.md):支持交互式与编程方式创建,通过 calculatedFieldSettings 定义 name 与 formula,公式支持运算符与函数,并可通过单独的 formatSettings 数组格式化。
- 透视图表集成(references/pivot-chart-integration.md):注入 PivotChartService;支持 21+ 图表类型;通过 displayOption 配置 Table/Chart/Both;支持字段列表、分组栏、多轴及累积图钻取。
- 筛选与排序(references/filtering-and-sorting.md):支持成员筛选、标签筛选、值筛选、Top/Bottom N、成员排序与自定义排序、值排序等。
- 数据格式化与条件格式(references/data-formatting.md):支持 Currency、Percentage、Number、Scientific 格式及自定义格式字符串与条件格式。
- 导出与打印(references/export-and-print.md):支持 Excel、PDF、CSV 导出及打印,支持多表导出与自定义。
- UI 定制(references/ui-customization.md):工具栏配置、报表管理、视图切换、总计/小计显示与自定义模板。
- 分组栏 UI 操作(references/grouping-bar-ui-operations.md):通过 showGroupingBar: true 启用,支持拖放重组、筛选、排序、移除与图标可见性控制。
- 工具提示定制(references/tooltips-customization.md):启用/禁用工具提示、自定义模板与占位符、CSS 样式。
- 编辑与钻取操作(references/editing-drill-operations.md):通过 allowEditing: true 启用(仅关系型数据),支持 Normal/Dialog/Batch/Command Column 编辑模式与 CRUD 操作、穿透与钻取。
- OLAP 数据源(references/olap-data-sources.md):配置 url、catalog、cube、providerType: 'SSAS',支持 MDX、层级、命名集与计算成员。
- 分页配置(references/paging-configuration.md):通过 enablePaging: true 并注入 PagerService,支持行列分页与页大小配置。
- 虚拟滚动(references/virtual-scrolling.md):通过 enableVirtualization: true 启用,支持单页模式 allowSinglePage。
- 钻取与穿透(references/drill-down.md):支持钻取、钻上、穿透查看原始数据。
- 数据库连接(references/database-connections.md):涵盖 SQL Server、MySQL、PostgreSQL、Oracle、MongoDB、Elasticsearch、Snowflake 及服务端处理。
- 服务端透视引擎(references/server-side-pivot-engine.md):通过 mode: 'Server' 将重处理委托给 ASP.NET Core 后端。
- 性能优化(references/performance-optimization.md):虚拟滚动、单页模式、分页、数据压缩、延迟更新与服务端处理。
- 状态持久化与超链接(references/state-persistence-hyperlinks.md):通过 getPersistData() 保存与恢复配置,支持 localStorage 与 JSON 序列化,以及单元格超链接。
【使用方式】 技能提供快速入门示例:导入 PivotViewAllModule 与 CalculatedFieldService,在独立组件中通过 providers 注入服务,并在模板中使用 <ejs-pivotview> 设置 dataSourceSettings、height、width、allowCalculatedField、allowGrouping 与 toolbar 等属性。技能同时强调应查阅 references/*.md 参考文件以核实 API 类名、属性和方法签名,不要从其他来源假设 API 细节。
【适用场景】 适用于需要在 Angular 应用中实现透视表、多维数据分析、OLAP 连接、图表联动、大数据量渲染优化以及导出报表的前端开发场景。
【限制与安全注意事项】 技能包含数据源安全校验要求:应使用本地内存数据源,仅连接受控且经过认证的 API 端点,不绑定不可信的用户提供的 URL,验证与清洗外部数据,使用 HTTPS、认证头与速率限制。声明编辑功能仅适用于关系型数据。技能同时提示虚拟滚动存在基于像素的 columnWidth 等限制。关于该技能的收费、价格、平台或具体效果等事实,资料中暂未提供。