Skip to content

表单事件配置 ​

表单事件关注「整张表」生命周期上的时机,例如提交、重置、渲染完毕,而不是某个输入框的点击。适合做提交前确认、打开时带默认值、远程请求前补公共参数等。

字段级点击、变更请用组件事件配置。动作节点怎么搭(确认弹窗、消息提醒、条件分支等)详见事件流配置。

在哪里找 ​

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

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

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

常见时机(对照界面) ​

左侧 事件列表 中的中文说明以界面为准:

界面说明标识(示意)典型用途
表单提交时触发onSubmit二次确认、整理数据、提示
表单验证通过时触发beforeSubmit校验已通过后的业务检查
表单重置后触发onReset恢复额外默认值
表单组件初始化完毕后触发onCreated准备初始上下文
表单组件渲染完毕后触发onMounted带远程默认值、聚焦首字段
表单组件卸载前触发onBeforeUnmount清理、草稿提示(按需)
表单渲染规则重载后触发onReload动态改规则后的收尾
表单组件的值发生变化时触发onChange轻量草稿提示(慎用重逻辑)
远程数据请求发送前触发beforeFetch统一补充 token、租户、语言等

怎么用(分步) ​

下面以「提交前二次确认」走通一遍:在 表单提交时触发 上用事件流加 确认弹窗。

  1. 打开右侧 表单配置,点 设置事件。

打开设置事件

  1. 弹出「设置事件」窗,左侧是 事件列表(含「表单提交时触发」等)。

事件列表

  1. 点选 表单提交时触发,右侧切到 事件流(另有 自定义 页,进阶才用)。

选中提交时机并切到事件流

  1. 在开始与结束之间点 +,出现 动作 / 条件。选 动作 插入动作节点。

点加号添加动作或条件

  1. 画布上出现「动作 / 点击配置动作」节点。

动作节点待配置

  1. 点开该节点,在 执行动作 里展开 弹窗,选择 确认弹窗。

选择确认弹窗

  1. 填写 标题、提示信息(如「确认提交」「确认提交本单?」),点 确定。

配置确认弹窗文案

  1. 事件流变为:开始 → 确认弹窗 → 结束。点 保存 / 确定 关闭后,用顶部 预览 验收。

事件流中的确认弹窗

提交确认与校验的顺序

预览时请先填好必填项再点提交;若字段校验未通过,可能先看到红字提示,确认框要等校验通过或按你配置的时机才会出现。需要「校验过了再确认」时,可改挂在 表单验证通过时触发。

场景示例 ​

入门:提交前二次确认 ​

背景:活动报名容易误点提交,希望先弹确认再继续。

步骤:

  1. 在表单事件里选 表单提交时触发,事件流中配置好 确认弹窗。

场景:提交时挂确认弹窗

  1. 预览:填好姓名、手机号后点 提交,应弹出确认;点取消则不继续。

预览提交前确认

预期:取消可反悔;确定后才继续后续动作(若还有提交/请求等,接在确认之后)。

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

背景:格式/必填已在字段验证配置里做完;还想在「都校验过了」时再提示附件或做总检。

步骤:

  1. 打开设置事件,选中 表单验证通过时触发。

选中表单验证通过时触发

  1. 同样用事件流加 消息提醒 或 确认弹窗(配置方式同「怎么用」)。

预期:与字段校验互补——字段管格式/必填,这里管跨字段总检。

常用:打开表单时带入默认值 ​

背景:打开报名表希望自动带上申请人等默认信息(可结合全局变量)。

步骤:

  1. 选中 表单组件渲染完毕后触发(或 初始化完毕后触发,按实际需要)。

选中渲染完毕时机

  1. 在事件流中添加 表单赋值 等动作,把默认值写入对应字段。

预期:打开即见默认值,仍允许用户修改。

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

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

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

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

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

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

使用建议 ​

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

相关阅读 ​

相关技术文档 ​