自定义流程布局/表单页面的二级操作按钮。

功能描述

在流程布局或表单页面，可以自定义二级操作按钮（如提交、取消等）的名称、显隐和顺序。

典型场景示例

• 场景 1：修改提交按钮文案
  例如：将"提交"改为"确认提交"
• 场景 2：隐藏不需要的按钮
  例如：某些业务场景下隐藏"保存草稿"按钮
• 场景 3：调整按钮顺序
  例如：将"取消"按钮放在"提交"之前

适用场景

• 需要精细控制表单页面的操作按钮
• 需要根据业务状态动态调整按钮展示
• 需要统一多个表单的按钮样式

适用页面

• 业务流编辑表单页

开发思路

功能增强通常可以拆成三步理解：

1. 明确要增强的是哪一个环节

   • 确定需要修改、隐藏或重排序的按钮

2. 选择合适的扩展事件/钩子

   • 移动端：flow.edit.form.render.before
   • Web端：bpm.process.render.before

3. 在插件中接入扩展点并验证行为

   • 调用 api.customFormButtons(fn) 方法(Web) 或 调用 api.updateBottomBtnList() 方法(移动端)
   • 传入回调函数处理按钮的 label、action、显隐等

开发流程

1. 明确按钮修改需求
   • 确定需要修改、隐藏或重排序的按钮
2. 编写按钮自定义逻辑
   • 根据特殊需求进行逻辑定制
3. 配置插件
   • 在自定义插件配置中选择对应插件

推荐入口

移动端

• flow.edit.form.render.before

Web 端

• bpm.process.render.before - customFormButtons

注意事项

1. 入参说明：回调函数中的按钮数组不包含"取消"操作按钮
2. 返回值要求：返回的按钮配置必须基于入参中的按钮进行定制
3. 显隐控制：如果某个按钮在返回数组中不存在，该按钮将被隐藏
4. 顺序控制：返回数组中按钮的顺序决定了按钮的显示顺序