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

在哪里找
在组件事件弹窗的 全局事件 页也可快捷管理。
和组件事件、表单事件、行为动作
| 层级 | 管什么 |
|---|---|
| 组件事件 | 某个字段/按钮何时触发 |
| 表单事件 | 整表提交/加载等何时触发 |
| 全局事件(本文) | 可复用的动作本身 |
| 事件流配置 | 动作流里每一步能做什么 |
典型模式:多处时机不同、动作相同 → 沉淀全局事件,各处只负责引用。
text
全局事件「打开请假须知」
↑ 引用
查看须知 按钮 click怎么用(分步)
1. 创建全局事件
- 打开全局配置 → 设置事件(入口见图文开头)。
- 点 创建事件,会出现两种类型:
- 自定义:右侧用脚本(
function handle($inject))实现 - 事件流:右侧用可视化流程(开始 → 动作/条件 → 结束)
- 自定义:右侧用脚本(

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

TIP
已有事件点左侧列表即可进入编辑:点方法名 / 标题进入脚本或事件流;编辑图标只改键名与标签。
1.1 用事件流配置动作
适合「打开弹窗、提示、赋值」等可点选的动作,与组件侧事件流配置同一套面板。
- 创建事件 时选 事件流。右侧出现 开始 → 结束 的空白流。

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

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

- 点右侧 保存,再点弹窗 确定。
1.2 用自定义脚本(含变量列表)
创建事件 时选 自定义,或打开已有脚本型事件后,右侧为脚本编辑区。

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

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

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

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

- 选中时机(如
click)。

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

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

场景示例
入门:多入口打开同一须知
背景:请假表「查看须知」等入口都要打开同一份须知弹窗。
步骤:
- 准备好「请假须知」模块(模块管理或画布内弹窗),画布上放好「查看须知」按钮。

- 按上文创建全局事件:可用 事件流 加「打开弹窗」动作(见
event-88~event-90),或用 自定义 脚本api.open(...)。 - 选中按钮 → 事件配置 → 设置事件 → 时机选
click→ 全局事件 页选用「打开请假须知」(界面操作同上一节「在组件事件中引用」)。其它入口重复本步即可。
预期:换须知模块时只改全局事件一处。
常用:选人后回填
背景:入职、调岗都要「打开选人 → 回填姓名部门」。
步骤:
- 将「打开选人」做成全局事件(事件流或自定义均可;回填字段 ID 一致时可一并放进该事件)。
- 各表按钮的
click都在 全局事件 页引用它(操作同入门第 3~4 步)。 - 若各表字段 ID 不同:全局事件只负责打开选人模块,回填留在各表自己的组件事件里。
预期:选人交互统一,表结构差异可局部处理。
常用:提交前统一确认
背景:多张表提交前要同一套确认文案。
步骤:
预期:文案与确认流程一处维护。
维护建议
| 建议 | 说明 |
|---|---|
| 命名见名知意 | evt_open_leave_notice、打开请假须知 |
| 写清标签 | 列表里方便配置人员选用 |
| 改前回归 | 影响所有引用入口,改完预览主路径 |
| 不要过度全局化 | 只用一次的流程写在组件事件即可 |
注意点
- 创建事件 分 自定义(脚本)与 事件流(可视化);两者保存形态不同,不要混用同一键名硬改类型。
- 引用后以界面显示的事件标签为准;改名后检查引用是否仍有效。
- 全局事件里打开的模块必须已存在。
- 与数据绑定、全局变量配合时,注意各表字段 ID 是否一致。


