Skip to content

事件配置 ​

事件配置:在组件发生某个时机(点击、值变化、失焦等)时,自动执行一串动作。适合「打开弹窗」「提示确认」「批量赋值」「校验后提交」等交互;能用隐藏条件 / 数据联动解决的,不必强上事件。

下面以「活动报名」中的「查看须知」按钮为例(打开模块管理中的「活动须知」弹窗)。

在哪里找 ​

选中组件 → 右侧 组件配置 → 事件配置 → 设置事件。

配置方式一览 ​

创建或选中左侧事件后,右侧通常有三类方式(以界面为准):

方式适合说明
事件流大多数业务可视化:条件分支 + 动作节点
全局事件多处复用引用全局事件
自定义特殊逻辑环境开放时用脚本补充(非必须)

怎么用(分步) ​

  1. 选中要响应交互的组件(如按钮「查看须知」)。

选中查看须知

  1. 右侧找到 事件配置,点 设置事件。

事件配置与设置事件

  1. 弹窗左侧可看到已有事件;点左侧事件标题进入右侧配置(仅点列表空白处不会展开右侧)。

事件列表

  1. 若还没有合适时机:点 创建事件,在下拉里选时机(如 click 点击组件时触发)。同一时机只能建一次;已用过的会灰掉。不同组件可选时机不同。

创建事件并选择时机

时机(示意)典型组件用途
点击按钮、链接打开模块、提交、跳转
值变化输入、下拉、单选回填、提示、刷新选项
获得 / 失去焦点输入框轻量校验提示
清除带清除按钮的输入清空关联字段
  1. 切到 事件流 页,查看「开始 → 动作 → 结束」。本例动作为「打开弹窗」。

事件流:打开弹窗

  1. 点开动作节点,配置具体动作。本例选 打开弹窗,在 选择弹窗 中指定「活动须知」。名称以界面为准,更多节点与参数见事件流配置。

配置打开弹窗与选择弹窗

  1. 保存并关闭后点顶部 预览,再点「查看须知」,确认「活动须知」弹窗出现。

预览打开活动须知

改用全局事件(可选) ​

同一时机下切到 全局事件 页,下拉选用已在全局事件中建好的事件。多入口同逻辑时优先这一方式。

全局事件页

自定义(进阶,可选) ​

切到 自定义 页,仅在环境开放且确有需要时使用。脚本区可按注释使用 $inject;大多数业务优先事件流或全局事件即可。

自定义脚本区

变量列表(脚本旁) ​

自定义页脚本编辑区右侧有一条窄栏,点展开图标打开 变量列表(界面说明:包含表单所有相关变量,点击变量可快速插入代码或复制名称)。

展开变量列表

展开后常见分组(以界面为准):

分组做什么
当前表单本表字段,点击插入形如 $topForm.字段ID 的引用
cookie / localStorage / sessionStorage浏览器侧存储相关变量
全局数据 / 全局变量$globalData、$var 等,见全局变量
国际化配置$t 词条,见国际化
设计器预览环境$isDesigner 等环境标记

可用顶部搜索框按关键字过滤。每项旁有 复制,也可点名称把引用插到脚本当前光标处。

变量列表面板

例如点「报销金额」,会在光标处插入 $topForm.字段ID(ID 以当前表为准)。

点击字段插入到脚本

TIP

脚本右下角还有 帮我写(AI 写事件),可用自然语言生成/改写脚本,见AI 表单助理。变量列表负责「点选插入字段名」;帮我写负责「按描述出整段逻辑」。

内置动作(产品说明) ​

配置时按分类挑选即可;名称以界面中文为准。完整参数见事件流配置。

弹层 / 提示(最常用) ​

动作做什么
打开弹窗 / 打开模块打开模块管理中的弹窗或抽屉
关闭模块关闭指定模块
消息提示成功 / 警告 / 错误 / 信息提示
确认弹窗先让用户确认,再继续后续动作

表单 ​

动作做什么
隐藏 / 显示字段运行时改显隐
禁用 / 启用字段运行时改可编辑
重置 / 清空回到初始值或清空
校验表单 / 校验字段触发表单或指定字段校验
提交表单走提交流程
设置字段值给一个或多个字段赋值

其它 ​

动作做什么
页面跳转 / 刷新打开链接或刷新
发送请求调接口
复制文本复制到剪贴板
打印 / 导出 PDF输出当前表单

动作链

多个动作按顺序执行;确认框、校验、请求等会完成后再进行下一步。可对单个动作设置跳过或中断条件。

场景示例 ​

入门:按钮打开须知弹窗 ​

背景:报名表要点「查看须知」打开说明弹窗。

按上文「怎么用」完成即可:模块管理中先有「活动须知」→ 按钮 click → 事件流「打开弹窗」并选择该模块 → 预览点按钮验证。

预期:点击即可打开须知(效果见上文预览步骤)。

其它常见用法

  • 提交前确认:在事件流中先加「确认弹窗」,再接「提交表单」等后续动作;预览时取消应不继续。节点细节见事件流配置。
  • 多入口复用:先在全局事件配好一套动作,各按钮在 全局事件 页引用同一事件,改一处即可同步。

执行条件与阻断 ​

  • 可为整段事件或单个动作设置执行条件。
  • 「阻断」类条件满足时,后续动作不再执行(如校验失败则不提交)。
  • 条件里可引用字段值、全局变量等(以界面可选为准)。
  • 画布上的 条件节点 与动作上的执行条件区别见事件流配置。

与隐藏 / 联动 / 公式怎么选 ​

需求优先
随字段值显隐隐藏条件
选项 / 赋值随其它字段变数据联动
计算展示计算公式
点击后打开弹窗、确认、请求事件配置(本文)

注意点 ​

  • 先选对组件与时机,再搭动作;点左侧事件标题才会展开右侧配置。
  • 打开弹窗前确认模块已在模块管理中存在。
  • 能复用时优先全局事件,避免多处复制同一事件流。
  • 预览要覆盖成功与取消路径。

相关阅读 ​

相关技术文档 ​