用途:面向 Syncfusion React Data Grid(@syncfusion/react-grid)的开发知识技能,帮助构建、修改、脚手架生成或调试该网格组件,也涵盖在其之上生成新 UI 的场景。不适用于 Angular/Vue/Blazor 网格、其他 Syncfusion React 组件(图表、日程、甘特、看板等)以及 TanStack Table 等非 React 表格。
主要能力:按主题提供参考文件,覆盖安装与模块导入、列配置与模板、单元格与行、数据绑定(本地/远程)、分页、排序、筛选、搜索、编辑各模式与校验、选择、分组聚合、虚拟化与滚动性能、自动填充/剪贴板/上下文菜单/工具栏、主从详情、实时网格、打印与 PDF/Excel 导出、树形数据、透视表、公式、工具面板、集成图表、数据更新(同步异步与批量流式)、无障碍、全球化、主题、安全与兼容性、防护规则及命令式 API。
使用方式:先判断用户意图(新脚手架、配置、调试或生成 UI),再读取对应参考文件后编码。每个网格需显式从 @syncfusion/react-grid 导入所需模块并注册;始终设置 enableDevMode={false};在启用编辑、选择持久化、setCellValue/setRowData、自动填充、剪贴板或复选框选择时,必须指定恰好一个 isPrimaryKey 列。命令式 API 通过 useRef<GridRef>(null) 调用,例如 gridRef.current?.method?.()。生成代码时建议用 useMemo 注册模块与记忆化 Grid JSX,模板用 useCallback 包裹,超过约 1000 行或流式/虚拟化场景使用固定 rowHeight。
限制与说明:缺少模块或缺主键会导致静默运行错误,容易被误判为数据问题。具体方法签名与完整配置细节需查阅对应参考文件;本技能不覆盖非 React 框架或其他组件库。迁移或聚合改动时需完成模块注册、具名导入与主题接入。缺失事实暂未提供。