用途:在 Angular 项目中实现 Syncfusion Grid 数据表格,用于展示结构化数据并完成排序、筛选、搜索、分页、编辑、分组、聚合、导出等数据操作,也支持层级数据、虚拟滚动与状态持久化。
主要能力:本地与远程数据绑定;列配置与模板、外键列;行、单元格与列的多种选择模式;单列与多列排序、筛选栏与筛选菜单、全局搜索、分页;内联、对话框、批量等编辑方式及内置校验;分组与汇总行、自定义聚合;Excel、PDF 导出与打印;冻结列、剪贴板、工具栏、右键菜单;主从/层级网格;虚拟滚动与无限滚动;状态保存与恢复;响应式与移动端适配;本地化与多语言、RTL;WCAG 2.2 与 Section 508 无障碍支持;通过多种 adaptor 对接后端。
必要用法与关键规则:编辑时必须为键列设置 [isPrimaryKey]="true",否则编辑会静默失败且不抛错。使用滚动或虚拟滚动时必须设置 height,否则滚动会被静默禁用;不要将 enableVirtualization 或 enableInfiniteScrolling 与 allowPaging 组合使用。行数小于 1000 可用 allowPaging,1K 至 100K 用 enableVirtualization 加 height,需要连续加载用 enableInfiniteScrolling 加 height,10 万行以上分组用 enableVirtualization 加 lazyLoadGrouping。不要在同一字段上同时使用列 template 和 rowDataBound,以免样式冲突;rowDataBound 与 queryCellInfo 会在每次渲染或滚动时触发,禁止在其中进行 API 调用。
模块与集成:Grid 自身不进行远程数据访问,外部 API 交互由独立的 DataManager 技能处理;不同功能需要注入对应服务模块,可参考模块与 adaptor 文档。
适用场景:员工目录、数据录入表单、销售报表等。
限制:上述规则来自资料说明;具体安装命令、收费与价格、平台支持、实际效果等未在资料中提供。