表单与字段

属性面板根据 FormSchema 渲染字段，并把 change 翻译成页面 AuthoringAction。

import type {
  FieldComponentDefinition,
  FieldComponentMap,
  FormSchema,
  TypedFormSchema,
} from '@dragcraft/designer'
import {
  resolveFieldComponentProps,
  useFormGeneratorContext,
  useFormValidation,
} from '@dragcraft/designer'

入口	用途
`FormSchema`、`FieldSchema`	描述 section、字段、联动与绑定位置。
`FieldComponentMap`	将稳定字段键映射为真实 Vue 控件。
`FieldComponentDefinition`	定义控件的 model prop、事件与值转换。
`FieldRenderFactory`	渲染当前表单专用的内容或操作区。
`TypedFormSchema`	结合字段 adapter 的 props map 提供 schema 类型提示。
`useFormGeneratorContext()`	为嵌套字段读取字段映射和表单状态。
`useFormValidation()`	在独立表单中读取并触发字段验证。
`resolveFieldComponentProps()`	解析动态 props 和国际化选项。

函数形式的 FieldSchema.component 总是 render factory。可复用 Vue 组件应先注册到 FieldComponentMap，再通过字符串键引用。

字段未声明 bindTo 时，Widget 表单写入 props.{key}，Global 表单写入 globalConfig.{key}。编辑节点样式、页面 surface 或容器 variant 时使用显式绑定。页面 surface 的绑定作用域是 schema，例如 root.style.surface.backgroundColor。

ifShow（旧别名为 visible）、show、disabled、dependencies、parseValue、valueFormat 和 rules 的选择标准及数据流见表单与字段。表单验证服务编辑体验，保存与发布服务仍需重新校验。

表单与字段 ​

表单与字段