Skip to content

表单事件配置

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

表单事件列表

在哪里找

表单配置表单事件 / 设置事件。

字段级点击、变更请用组件事件配置。多表单复用的动作可沉淀为全局事件

和组件事件、全局事件的分工

层级管什么例子
表单事件(本文)整表时机提交前确认、打开时带默认人
组件事件某个字段/按钮点「选择商品」打开模块
全局事件可复用动作流多处共用的「打开选人」

常见时机

事件(界面文案可能略有差异)何时触发典型用途
表单提交时用户提交二次确认、整理数据、提示
表单验证通过时校验已通过、即将继续提交最后一道业务检查
表单重置后用户重置恢复额外状态、清临时变量
初始化完毕表单组件初始化完成准备初始上下文
渲染完毕挂载完成加载远程默认值、聚焦首字段
卸载前离开表单前清理、草稿提示(按需要)
规则重载后渲染规则重载动态改规则后的收尾
值发生变化时任意字段值变轻量统计、草稿提示(慎用重逻辑)
远程请求发送前远程数据请求发出前统一补充 token、租户、语言等

业务示例

入门:提交前二次确认

时机:表单提交时。 动作:弹出确认框——「确认提交本单?」;取消则中止。 预期:误点提交可反悔。

入门:打开表单时带入申请人

时机:初始化完毕或渲染完毕。 动作:把当前用户姓名写入「申请人」(可结合全局变量)。 预期:打开即见默认值,仍允许修改。

常用:校验通过后再做业务检查

时机:表单验证通过时。 动作:例如金额过大时再弹提示「需附件,是否已上传?」;或调用自定义动作做额外规则。 与字段级验证配置互补:格式/必填在字段上,跨字段总检可放这里。

常用:请求前补充公共信息

时机:远程数据请求发送前。 动作:统一附带租户、语言、token 等,避免每个全局数据源或远程选项重复配置。

常用:重置后恢复默认部门

时机:表单重置后。 动作:再次写入默认「所属部门」,避免重置后关键默认值丢失。

常用:值变化时轻量提示草稿

时机:值发生变化时。 动作:仅做轻量提示(如「有未保存修改」),不要每次按键都发重请求或打开模块。

使用建议

  • 整表级、只做一次的逻辑放表单事件;字段级放组件事件或隐藏/必填/联动
  • 「值发生变化」避免沉重操作,防止填写卡顿。
  • 公共动作沉淀为全局事件,表单事件只负责「何时调用」。
  • 改完务必预览;设计态点选不等于真实提交链路。

相关阅读

相关技术文档