简体中文
查看详情按钮自定义
约 536 字大约 2 分钟
2026-05-08
自定义任务"查看详情"按钮文案和显隐状态。
适用场景
适用于Web端。
功能描述
在任务渲染之前,可以自定义查看详情按钮的名称,并控制其显示或隐藏。
典型场景示例
- 场景 1:加签节点显示特殊文案
例如:将"查看详情"改为"查看加签详情" - 场景 2:完成后隐藏详情按钮
例如:任务已完成时隐藏"查看详情"按钮 - 场景 3:催办任务标记
例如:被催办的任务显示特殊标记
适用场景
- 需要为不同任务类型配置不同的详情按钮文案
- 需要根据任务状态控制详情按钮显隐
- 需要在详情按钮上显示任务状态标记
适用页面
- 业务流详情页-任务区域
开发思路
功能增强通常可以拆成三步理解:
明确要增强的是哪一个环节
- 确定需要修改的 taskId
- 确定按钮文案和显隐状态
选择合适的扩展事件/钩子
- Web 端:
bpm.detailCard.render.before
- Web 端:
在插件中接入扩展点并验证行为
- 获取任务 ID 和当前详情按钮状态
- 根据业务逻辑判断是否修改文案或显隐,通过
api.customViewDetailButton()提交
开发流程
- 确定自定义需求
- 明确需要修改的 taskId
- 确定按钮文案和显隐状态
- 选择事件
- Web 端:
bpm.detailCard.render.before
- Web 端:
- 编写自定义逻辑
export default class Plugins{ apply() { return [ { event: 'bpm.detailCard.render.before', functional: this.detailCardRenderBefore.bind(this) } ] } detailCardRenderBefore(api) { api.customViewDetailButton([{taskId:'65e5879aa10a002e989c8106',text:'这是加签节点查看详情1',isShow:true},{taskId:'65e5879aa10a002e989c8107',text:'这是加签节点查看详情2',isShow:true}]) } } - 配置插件
- 在自定义插件配置中选择对应插件
推荐入口
注意事项
- taskId 必须正确:需要准确指定要修改的任务 ID
- isShow 默认为 true:不设置 isShow 时默认显示按钮
- 支持批量配置:可以一次性传入多个任务的配置
