SuperAPI AI 工具集

docyrus-dynamic-form-design

设计与创作

查看项目

更新于 10-15 21:11

技能介绍

用途:为 Docyrus 的某个数据源设计动态表单布局,即记录创建/编辑/查看界面的字段选择、顺序、栅格、分组、必填与联动规则,保存为表单行上的 layout JSON,由 useDocyrusFormView(或无后端的 useDynamicFormView)渲染。

主要能力:表单只引用字段、不定义字段,每个字段节点须通过 fieldConfig.slug(优先)或 dataSourceFieldId 绑定到数据源已有字段;未列出的字段不渲染(白名单);支持 required、computedRequired、字段级 customValidations、表单级 formCustomValidations,以及 minLength/maxLength/pattern/min/max 等 token(仅在宿主开启 validationTokens 时运行时生效);支持 computedHidden/computedRequired/computedLabel/computedDescription/computedFormula 等计算键,以及 fieldActions 与 formActions(onFormLoad/onFormBeforeSubmit/onFormAfterSubmit)条件动作,表达式用 JSONata 或 Query Builder JSON。

使用方式:先用 docyrus whoami --json、docyrus apps list --json、docyrus studio list-fields --appSlug crm --dataSourceSlug contact --json 获取真实字段 slug;用 list-forms/get-form 查看已有表单;按 references/form-layout-schema.md 编写布局,用 create-form 或 update-form 保存,布局放文件里通过 --layout "$(cat form.layout.json)" 或 --from-file 传入;保存后用 get-form 回读核对。

限制:update-form --layout 为整体替换而非深合并;--isDefault true 会切换默认表单,操作前需确认;--status 为数字状态码,建议从现有表单复制;无法解析的绑定会被静默丢弃;表达式引用错误 slug 会静默失效。具体平台与收费信息暂未提供。