OverlayForm 覆盖层表单

xy-overlay-form 用来统一表达“在当前页面上下文中打开一个覆盖层表单”的能力，通过 container="drawer" | "modal" 收口抽屉与弹窗两种编辑容器。若页面已经明确固定使用其中一种容器，也可以直接使用 xy-dialog-form 或 xy-drawer-form 这两个 facade。

覆盖层编辑场景

这个场景把“列表内快速编辑”和“轻量属性修改”统一放到同一套覆盖层表单心智里。

这里不再把“抽屉表单”和“弹窗表单”当作两套独立能力来理解，而是统一理解为覆盖层编辑。

体量较大、需要保留列表上下文时走抽屉；字段较少、只想做快速确认时走弹窗。

关闭生命周期

resetOnClose 负责重置字段与校验态，destroyOnClose 负责关闭后卸载内容，两者可以同时启用。

`resetOnClose` 只负责重置字段与校验态，不卸载内容节点。

`destroyOnClose` 会在关闭后卸载内容，下次打开重新挂载。

挂载 0 次，卸载 0 次

当前定位

统一表达覆盖层编辑内核，不要求使用方为抽屉和弹窗维护两套底层逻辑。
适合后台列表页中的创建、编辑、补充说明、轻量审批等链路。
在收口后的公开体系里，它应是 CrudPage、ListPage 和详情链路的上游编辑容器。
当 mode='view' 时，会直接切到只读详情展示协议，而不是继续显示禁用态字段控件。

OverlayForm API

OverlayForm Attributes

属性	说明	类型	默认值
`open`	是否打开	`boolean`	`false`
`container`	覆盖层容器类型	`'drawer' \| 'modal'`	`'drawer'`
`mode`	表单模式	`'create' \| 'edit' \| 'view'`	`'create'`
`title`	标题	`string`	`''`
`model`	表单数据	`Record<string, unknown>`	—
`schema`	字段 schema	`ProFieldSchema[]`	`[]`
`rules`	表单规则	`FormRules`	`{}`
`loading`	初始加载态	`boolean`	`false`
`submitting`	提交中态	`boolean`	`false`
`readonly`	是否只读	`boolean`	`false`
`reset-on-close`	关闭后是否重置字段与校验态	`boolean`	`false`
`destroy-on-close`	关闭后是否卸载表单内容，下次打开重新挂载	`boolean`	`false`
`drawer-props`	透传给抽屉容器的属性	`Partial<DrawerProps>`	`{}`
`dialog-props`	透传给弹窗容器的属性	`Partial<DialogProps>`	`{}`

OverlayForm Events

事件名	说明	参数
`update:open`	打开状态变化时派发	`(value: boolean) => void`
`submit`	提交成功时派发	`({ mode, model }) => void`
`cancel`	取消时派发	`({ mode, model }) => void`
`closed`	覆盖层完全关闭后派发	`() => void`

OverlayForm Slots

插槽	说明
`default`	表单内容
`actions`	自定义底部动作区

OverlayForm 覆盖层表单 ​

覆盖层编辑场景 ​

成员台账

关闭生命周期 ​

当前定位 ​

OverlayForm API ​

OverlayForm Attributes ​

OverlayForm Events ​

OverlayForm Slots ​