SuperAPI AI 工具集

docyrus-data-grid-page-design

数据与分析

查看项目

更新于 10-16 05:07

技能介绍

用途:围绕 Docyrus Web DataGrid 技术栈构建完整的列表页,覆盖标准 Docyrus 页面、自定义布局页面以及无后端保存视图的场景。

主要能力:useDocyrusDataGrid 适合行数据来自 Docyrus 数据源或生成集合的标准页面,提供元数据驱动列、保存视图、工具栏、搜索、筛选(关系/用户字段支持异步选项搜索)、分组、排序、行高、显示模式、分页与重载,并自动处理引用字段展开、租户感知格式化与共享用户列表;内置行内变更跟踪与保存横幅(trackChanges、onSaveChanges)、选择栏批量操作(bulkActions:update、delete、export)及 BulkUpdateDialog、RecordDeleteConfirmDialog,以及服务端导出菜单(enableServerExportMenu、exportColumns、exportFileName、serverExportLimit)。useDocyrusDataViewSelect 与 useDataGrid 组合适合自定义工具栏、本地/演示数据或非标准取数流程;useDataGrid 配合本地 SavedDataGridView[] 或 DataGridViewMenu 可处理无后端保存视图。

使用方式:先确认 appSlug、dataSourceSlug 及生成集合是否存在,再选择钩子模式或手动模式。应用层需用 TenantProvider 与 UsersProvider 包裹路由,并将 formatDate、formatDateTime、formatNumber、users 传入网格钩子。保留列顺序为 select 在前、actions 在后,由 useDocyrusDataGrid 自动左固定。页面采用 flex 列布局,网格主体包裹在 min-h-0 flex-1 中,工具栏置于 shrink-0 行。全页布局推荐 <DataGrid table={table} {...gridProps} height="auto" />。手动 Docyrus 查询必须传 columns,引用字段还需加入 expand 数组。手动页面需在视图与列就绪后调用 applyViewToTable(table, activeView)。

适用场景:Docyrus 记录列表页、数据网格页、带保存视图与批量操作的业务列表。

限制:useDocyrusDataViewSelect 仅管理视图元数据,不取行数据也不接受 table;后端保存视图筛选需要枚举选项;复杂查询需加载 docyrus-api-dev 技能。具体安装命令与代码示例资料未提供。