SuperAPI AI 工具集

docyrus-record-detail-form-design

前端与建站

查看项目

更新于 10-15 21:11

技能介绍

用途:围绕共享字段元数据,构建 Docyrus 记录的新建、编辑和详情体验,覆盖标准表单页、详情面板、检查器面板与行内编辑记录 UI。

主要能力与模式选择:标准创建/编辑/查看记录页使用 useDocyrusFormView,它处理元数据加载、条目加载、选项注水、字段渲染与提交行为(参考 references/hook-form-view.md)。自定义手动表单或详情布局使用 DynamicFormField、DynamicValue 或 useDocyrusFieldComponent,适合页面已自行管理表单状态、布局或数据获取的场景(参考 references/manual-form-detail-patterns.md)。行内编辑、点击即改的详情行或逐字段编辑使用 EditableRecordDetail 与 EditableValue(参考 references/advanced-inline-edit-and-renderers.md)。涉及复杂查询、schema 或 API 工作时,另行加载 docyrus-api-dev 或 docyrus-app-dev-react。字段类型映射或不受支持字段的处理,参考 references/field-type-mapping-and-fallbacks.md。

默认工作流:确认 appSlug、dataSourceSlug、mode,以及记录已存在时的 itemId;决定页面是 hook 优先还是完全手动;让可编辑字段与只读渲染器共用同一字段类型注册表;在页面完成前注水枚举、用户与关系选项;验证创建、编辑、查看、重置与保存行为;若支持行内编辑,验证 money、phone、status 等复合类型的伴随字段保存。

必要约束:标准创建/编辑/查看页优先使用 useDocyrusFormView;手动可编辑布局应使用 DynamicFormField、特定表单字段组件或 useDocyrusFieldComponent(..., 'form-field');手动只读布局应使用 DynamicValue、特定值渲染器或 useDocyrusFieldComponent(..., 'value-renderer');已有共享注册表负责分发时,不要另写逐字段 switch;手动获取 Docyrus 条目必须传 columns,useDocyrusFormView 会自动推导含伴随列;复合字段(money、phone、status、avatar 等)在手动保存流程中必须保持伴随键完整;字段无可编辑组件时,创建模式通常跳过,编辑/查看模式通常回退到值渲染器,除非有更明确的显式设计。

限制:本技能面向 Docyrus 生态的 React 界面实现,具体安装命令、版本要求与平台范围资料暂未提供。