表单事件配置
表单事件关注「整张表」生命周期上的时机,例如提交、重置、加载完成,而不是某个输入框的点击。适合做提交前确认、初始化带数、统一处理远程请求前的公共参数等。

在哪里找
表单配置 → 表单事件 / 设置事件。
字段级点击、变更请用组件事件配置。多表单复用的动作可沉淀为全局事件。
和组件事件、全局事件的分工
| 层级 | 管什么 | 例子 |
|---|---|---|
| 表单事件(本文) | 整表时机 | 提交前确认、打开时带默认人 |
| 组件事件 | 某个字段/按钮 | 点「选择商品」打开模块 |
| 全局事件 | 可复用动作流 | 多处共用的「打开选人」 |
常见时机
| 事件(界面文案可能略有差异) | 何时触发 | 典型用途 |
|---|---|---|
| 表单提交时 | 用户提交 | 二次确认、整理数据、提示 |
| 表单验证通过时 | 校验已通过、即将继续提交 | 最后一道业务检查 |
| 表单重置后 | 用户重置 | 恢复额外状态、清临时变量 |
| 初始化完毕 | 表单组件初始化完成 | 准备初始上下文 |
| 渲染完毕 | 挂载完成 | 加载远程默认值、聚焦首字段 |
| 卸载前 | 离开表单前 | 清理、草稿提示(按需要) |
| 规则重载后 | 渲染规则重载 | 动态改规则后的收尾 |
| 值发生变化时 | 任意字段值变 | 轻量统计、草稿提示(慎用重逻辑) |
| 远程请求发送前 | 远程数据请求发出前 | 统一补充 token、租户、语言等 |
业务示例
入门:提交前二次确认
时机:表单提交时。 动作:弹出确认框——「确认提交本单?」;取消则中止。 预期:误点提交可反悔。
入门:打开表单时带入申请人
时机:初始化完毕或渲染完毕。 动作:把当前用户姓名写入「申请人」(可结合全局变量)。 预期:打开即见默认值,仍允许修改。
常用:校验通过后再做业务检查
时机:表单验证通过时。 动作:例如金额过大时再弹提示「需附件,是否已上传?」;或调用自定义动作做额外规则。 与字段级验证配置互补:格式/必填在字段上,跨字段总检可放这里。
常用:请求前补充公共信息
时机:远程数据请求发送前。 动作:统一附带租户、语言、token 等,避免每个全局数据源或远程选项重复配置。
常用:重置后恢复默认部门
时机:表单重置后。 动作:再次写入默认「所属部门」,避免重置后关键默认值丢失。
常用:值变化时轻量提示草稿
时机:值发生变化时。 动作:仅做轻量提示(如「有未保存修改」),不要每次按键都发重请求或打开模块。
使用建议
- 整表级、只做一次的逻辑放表单事件;字段级放组件事件或隐藏/必填/联动。
- 「值发生变化」避免沉重操作,防止填写卡顿。
- 公共动作沉淀为全局事件,表单事件只负责「何时调用」。
- 改完务必预览;设计态点选不等于真实提交链路。


