内置动作列表

本文为你列举了设计器中目前支持的所有内置动作，按分类如下：

页面操作动作 (page)

动作名称	功能描述	配置说明
redirectPage	页面跳转	支持 location（当前窗口/新窗口）和 router（路由跳转）两种类型，使用 router 类型时需要注入 $router 实例
reloadPage	页面刷新	无配置参数，直接刷新当前页面

模型操作动作 (model)

动作名称	功能描述	配置说明
openModel	打开弹窗	需要选择已定义的弹窗组件（通过 model 字段选择）
closeModel	关闭弹窗	需要选择要关闭的弹窗组件（通过 model 字段选择）
message	显示消息提示	支持 info、warning、success、error 四种类型，可配置消息内容、显示时长、是否显示关闭按钮
confirm	显示确认对话框	需要配置标题和消息内容，返回 Promise，用户确认后继续执行后续动作

表单操作动作 (form)

动作名称	功能描述	配置说明
hidden	隐藏/显示字段	支持静态配置或公式计算，可同时操作多个字段，通过 id 字段选择目标字段
disabled	禁用/启用字段	支持静态配置或公式计算，可同时操作多个字段，通过 id 字段选择目标字段
resetFields	重置表单	无配置参数，重置所有字段到初始值
clearFields	清空表单	无配置参数，清空所有字段的值
validate	验证表单	无配置参数，验证整个表单，返回 Promise
validateFields	验证指定字段	通过 id 字段选择要验证的字段，可同时验证多个字段
submit	提交表单	无配置参数，触发表单提交，返回 Promise
setValue	设置字段值	支持静态值或公式计算，可同时设置多个字段的值，通过 formData 数组配置字段和值

其他动作 (other)

动作名称	功能描述	配置说明
fetch	发送请求	支持完整的请求配置（URL、方法、参数等），可配置是否追加表单数据，支持设置响应数据存储位置
print	打印表单	无配置参数，调用浏览器打印当前表单内容
exportPdf	导出 PDF	无配置参数，将表单内容导出为 PDF 文件
emitEvent	抛出业务事件	需要配置 eventName（事件名会加上 biz- 前缀）和可选参数 args，用于设计器与业务逻辑解耦
copy	复制文本	支持静态文本或公式计算，将内容复制到剪贴板
callback	自定义回调	需要编写回调函数，接收 $inject 参数，抛出异常时会阻止后续动作执行

使用注意事项

内置动作使用注意事项

• 路由依赖：redirectPage 动作在使用 router 类型时需要通过 formCreate.setData('$router', router) 注入 $router 实例
• 字段引用：表单操作动作（hidden、disabled、validateFields、setValue）需要确保字段ID正确且字段存在
• 公式计算：支持公式计算的动作（hidden、disabled、setValue、copy）可以通过 compute 选项启用公式模式
• Promise 处理：返回 Promise 的动作（validate、validateFields、submit、fetch、confirm、print、exportPdf）会等待执行完成后再继续后续动作
• 动作链执行：多个动作按顺序执行，如果某个动作返回 Promise，会等待其完成后再执行下一个动作
• 业务事件：emitEvent 动作会触发以 biz- 为前缀的事件，可通过 api.top.on('biz-事件名', handler) 监听

扩展动作操作

详细文档