Skip to content

全局事件 ​

全局事件把可复用的交互逻辑做成「事件资产」。在组件或表单的事件配置里选用,避免每个按钮重复搭同一套动作。

全局配置中的设置事件入口

在哪里找 ​

左侧功能栏 → 全局配置 → 设置事件。

在组件事件弹窗的 全局事件 页也可快捷管理。

和组件事件、表单事件、行为动作 ​

层级管什么
组件事件某个字段/按钮何时触发
表单事件整表提交/加载等何时触发
全局事件(本文)可复用的动作本身
事件流配置动作流里每一步能做什么

典型模式:多处时机不同、动作相同 → 沉淀全局事件,各处只负责引用。

text
全局事件「打开请假须知」
    ↑ 引用
查看须知 按钮 click

怎么用(分步) ​

1. 创建全局事件 ​

  1. 打开全局配置 → 设置事件(入口见图文开头)。
  2. 点 创建事件,会出现两种类型:
    • 自定义:右侧用脚本(function handle($inject))实现
    • 事件流:右侧用可视化流程(开始 → 动作/条件 → 结束)

创建事件:自定义或事件流

  1. 选一种类型后,输入事件名称(如「打开请假须知」)并确认,再在右侧配置逻辑后点 保存,最后弹窗 确定。

创建事件名称示例

TIP

已有事件点左侧列表即可进入编辑:点方法名 / 标题进入脚本或事件流;编辑图标只改键名与标签。

1.1 用事件流配置动作 ​

适合「打开弹窗、提示、赋值」等可点选的动作,与组件侧事件流配置同一套面板。

  1. 创建事件 时选 事件流。右侧出现 开始 → 结束 的空白流。

全局事件的事件流面板

  1. 悬停中间 加号,选 动作 或 条件。

加号菜单:动作或条件

  1. 在流程上配置动作节点(如 打开弹窗)。动作参数的填法见事件流配置。

事件流中的打开弹窗动作

  1. 点右侧 保存,再点弹窗 确定。

1.2 用自定义脚本(含变量列表) ​

创建事件 时选 自定义,或打开已有脚本型事件后,右侧为脚本编辑区。

脚本型全局事件

脚本旁有窄栏,点展开图标打开 变量列表:

展开变量列表

列表含当前表单字段、存储、全局变量($var)、国际化等;点击插入到光标处,或点 复制。

变量列表面板

例如点「当前申请人」,可插入 $var.var_current_user(键名以你环境为准)。

点击插入全局变量

TIP

打开弹窗类优先用 事件流;需要读字段 / $var 再算的逻辑用 自定义 脚本。右下角 帮我写 见AI 表单助理;变量列表面板说明见事件配置 · 变量列表。

2. 在组件事件中引用 ​

  1. 选中要引用的按钮 → 事件配置 → 设置事件。

右侧设置事件

  1. 选中时机(如 click)。

选择 click 时机

  1. 右侧切到 全局事件 页,下拉选用「打开请假须知」。

全局事件页选用打开请假须知

  1. 预览点击按钮,确认效果。

画布按钮已引用全局事件

场景示例 ​

入门:多入口打开同一须知 ​

背景:请假表「查看须知」等入口都要打开同一份须知弹窗。

步骤:

  1. 准备好「请假须知」模块(模块管理或画布内弹窗),画布上放好「查看须知」按钮。

表单画布与查看须知

  1. 按上文创建全局事件:可用 事件流 加「打开弹窗」动作(见 event-88~event-90),或用 自定义 脚本 api.open(...)。
  2. 选中按钮 → 事件配置 → 设置事件 → 时机选 click → 全局事件 页选用「打开请假须知」(界面操作同上一节「在组件事件中引用」)。其它入口重复本步即可。

预期:换须知模块时只改全局事件一处。

常用:选人后回填 ​

背景:入职、调岗都要「打开选人 → 回填姓名部门」。

步骤:

  1. 将「打开选人」做成全局事件(事件流或自定义均可;回填字段 ID 一致时可一并放进该事件)。
  2. 各表按钮的 click 都在 全局事件 页引用它(操作同入门第 3~4 步)。
  3. 若各表字段 ID 不同:全局事件只负责打开选人模块,回填留在各表自己的组件事件里。

预期:选人交互统一,表结构差异可局部处理。

常用:提交前统一确认 ​

背景:多张表提交前要同一套确认文案。

步骤:

  1. 创建全局事件「提交确认」(事件流里加确认弹窗等动作,详见事件流配置)。
  2. 在表单事件「提交时」的 全局事件 页引用该事件。
  3. 抽查几张表的提交路径,确认文案一致。

预期:文案与确认流程一处维护。

维护建议 ​

建议说明
命名见名知意evt_open_leave_notice、打开请假须知
写清标签列表里方便配置人员选用
改前回归影响所有引用入口,改完预览主路径
不要过度全局化只用一次的流程写在组件事件即可

注意点 ​

  • 创建事件 分 自定义(脚本)与 事件流(可视化);两者保存形态不同,不要混用同一键名硬改类型。
  • 引用后以界面显示的事件标签为准;改名后检查引用是否仍有效。
  • 全局事件里打开的模块必须已存在。
  • 与数据绑定、全局变量配合时,注意各表字段 ID 是否一致。

相关阅读 ​

相关技术文档 ​