行为动作
行为动作是事件流里「真正执行的一步」:打开模块、设值、校验、发请求、提示等。配置事件时先选时机,再按顺序添加动作;多个动作组成动作链。
本文是动作能力的完整说明;何时触发请看事件配置、表单事件、全局事件。

在哪里用到动作
| 入口 | 说明 |
|---|---|
| 组件事件 | 点击、值变化等 → 事件流里添加动作 |
| 表单事件 | 提交、加载完成等 → 同样可挂动作 |
| 全局事件 | 沉淀可复用的动作流,再被引用 |
| 插槽点击等 | 部分插槽支持点击后再走事件 / 动作 |
动作链怎么执行
text
动作1 → 动作2 → 动作3 → …| 机制 | 含义(界面文案) |
|---|---|
| 顺序执行 | 默认按添加顺序往下走 |
| 等待完成 | 确认框、校验、请求、打印等会等完成后再继续 |
| 执行条件 | 条件成立才执行该动作,否则跳过 |
| 阻断条件 | 条件成立则后面的动作不再执行 |
| 执行异常 | 出错后是继续还是中断(「执行异常」) |
条件写法见使用逻辑条件。
内置动作一览
名称以界面中文为准。与事件配置中的简表对应,本文补充配置要点。
页面
| 动作 | 做什么 | 配置要点 |
|---|---|---|
| 跳转页面 | 打开指定地址或路由 | 链接跳转(浏览器地址)或 路由跳转(单页应用路径);可开新窗口 / 当前窗口 |
| 刷新页面 | 刷新当前页 | 一般无需参数 |
链接 vs 路由
链接跳转是传统整页跳转;路由跳转用于单页应用内切换。路由方式需环境已提供路由能力,否则请用链接跳转。
弹层 / 提示
| 动作 | 做什么 | 配置要点 |
|---|---|---|
| 打开弹窗 / 打开模块 | 打开模块管理中的弹窗 / 抽屉 | 选择目标模块;可带表单数据、提交回调(以界面为准) |
| 关闭弹窗 / 关闭模块 | 关闭当前或指定弹窗 | 选择要关的模块 |
| 消息提醒 | 顶部 / 角落提示 | 类型:信息 / 成功 / 警告 / 错误;文案、时长、是否显示关闭 |
| 确认弹窗 | 让用户确认后再继续 | 标题 + 内容;用户取消则后续动作不继续 |

表单
| 动作 | 做什么 | 配置要点 |
|---|---|---|
| 组件可见性 | 显示或隐藏指定组件 | 可选多个;静态或表达式 / 公式 |
| 组件可用性 | 启用或禁用指定组件 | 同上 |
| 重置表单 | 恢复为初始值 | — |
| 清空表单 | 清空字段值 | — |
| 校验表单 | 校验整表 | 失败时通常阻断后续(配合阻断 / 异常策略) |
| 校验表单项 | 只校验选中的字段 | 多选字段 |
| 表单赋值 | 给一个或多个字段设值 | 静态值或表达式 / 公式 |
| 提交表单 | 手动触发提交 | 会走表单提交相关流程 |
其它
| 动作 | 做什么 | 配置要点 |
|---|---|---|
| 发送请求 | 调用接口 | 地址、方法、参数等;可「追加表单数据」;结果可存到变量 |
| 打印表单 | 调起打印 | — |
| 导出 PDF | 导出当前表单为 PDF | — |
| 复制内容 | 复制到剪贴板 | 静态文本或表达式 |
| 抛出事件 | 通知外部业务 | 事件名称 + 可选参数(供宿主页面监听) |
| 自定义操作 | 用脚本补充 | 仅在内置动作不够时使用 |

环境可通过扩展注册更多动作,列表以界面实际项为准。
怎么配置(分步)
- 在事件中进入事件流。
- 点击 添加动作,按分类选择。
- 填该动作的参数(目标字段、模块名、文案等)。
- 需要时设置执行条件 / 阻断条件。
- 调整动作顺序(先确认再校验再提交,等)。
- 预览:成功路径、取消确认、校验失败各走一遍。
业务示例
入门:打开须知再关闭
text
点击「查看须知」
→ 打开模块(活动须知)须知内「我知道了」:
text
点击
→ 关闭模块入门:提交前确认
text
点击「提交」
→ 确认弹窗(确认提交本单?)
→ 校验表单
→ 提交表单用户点取消,确认未通过,后续不执行。

常用:选人回填
text
主表「选择」点击 → 打开模块(选人)
弹窗「确定」点击 → 表单赋值(姓名、部门)→ 关闭模块常用:校验联系方式再进入下一步
text
点击「下一步」
→ 校验表单项(手机号、邮箱)
→(失败则消息提醒,并阻断后续)
→ 打开模块(步骤二)或跳转页面常用:复制单号
text
点击「复制」
→ 复制内容(取单号字段或表达式)
→ 消息提醒(已复制)也可把「复制」放在字段插槽后缀图标的点击上。
常用:保存草稿到接口
text
点击「存草稿」
→ 发送请求(草稿接口,追加或部分表单数据)
→ 成功则消息提醒;结果写入变量供后续使用常用:按条件跳过打印
对「打印表单」动作设执行条件:仅当「需要纸质存档」= 是 时执行;否则跳过该动作,继续后面的关闭模块等。
常用:无权限则阻断导出
结合身份与权限:导出动作前加确认;或对「打开导出」设执行条件为权限包含导出权,否则消息提醒并阻断。
配置技巧
| 技巧 | 说明 |
|---|---|
| 先模块后动作 | 打开模块前,先在模块管理建好目标 |
| 字段 ID 正确 | 赋值、显隐、校验依赖稳定的字段 ID |
| 公式 / 表达式 | 赋值、显隐、复制等支持表达式时,可引用字段与变量 |
| 复用 | 多按钮相同流程 → 全局事件 |
| 少用自定义 | 团队协作优先可视化动作,便于他人维护 |
| 与变量配合 | 请求结果、开关位可写入变量,再给变量绑定用 |
注意点
- 值变化事件里避免过重请求,防止输入卡顿。
- 抛出事件需宿主页面按约定监听,否则「点了没反应」。
- 路由跳转依赖环境路由;不确定时用链接跳转。
- 长期显隐不要只靠动作「点一次」,应用隐藏条件自动算。


