纷享销客开发者手册

简体中文

English

approval.agree.render.after

约 1769 字大约 6 分钟

2025-12-16

说明：该事件用于审批同意渲染之后调用

该事件用于审批同意渲染之后执行额外的动作，包括但不限于以下功能： 1. 获取流程数据 2. 自定义并行加签的文案 3. 自定义串行加签的文案 4. 自定义审批弹窗标题内容文案 5. 自定义控制后加签功能的隐藏和展示 6. 自定义审批意见输入框标题 7. 自定义设置审批内容表单/页面，【处理审批】区域的内容

参数

参数说明类型
getData获取流程数据（示例）Function
setParallelLabelStyle自定义并行加签的文案（示例）Function
setSerialLabelStyle自定义串行加签的文案（示例）Function
setDialogTitle自定义审批弹窗标题内容文案（示例）Function
showAfterAddSign自定义控制后加签功能的隐藏和展示（示例）Function
setOpinionLabel自定义审批意见输入框标题（示例）Function
setSwitchLabel自定义设置审批内容表单/页面，【处理审批】区域的内容（示例）Function
showSwitchContent自定义设置审批内容表单/页面，隐藏处理审批开关容器+label文案（示例）Function
showSwitchContainer自定义设置审批内容表单/页面，隐藏处理审批开关容器（示例）Function
forceSwitchContainer自定义设置审批内容表单/页面，强制打开/关闭 处理审批开关（示例）Function

示例

一、getData

功能描述

获取流程的一些数据，用户可以以此作为判断依据，运行不同的业务逻辑（例如：根据sourceWorkflowId区分不同的审批流，从而进行不同的代码逻辑）。

参数

无

返回结果

参数说明类型
instanceId实例IDString
entityId对象的ApiNameString
objectId对象IDString
taskId任务IDString
taskName任务名称String
sourceWorkflowId原始流程IDString
activityId节点IDString

参数代码示例

无

代码示例

// getData()
export default class Plugin {
    apply() {
        return [
            {
                event: 'approval.agree.render.after',
                functional: this.approvalAgreeRenderAfter.bind(this)
            }
        ]
    }

    approvalAgreeRenderAfter(api) {
        let data = api.getData();
        console.log(data, '流程数据');
    }
}

二、setParallelLabelStyle

功能描述

用户可以自定义设置并行加签的文字内容。

参数

参数说明类型
Dom对象/html字符串自定义设置文字内容和样式Object/String
false隐藏并行加签文字内容Boolean

注：不传参数，表示使用默认标题

返回结果

无

参数代码示例

// 以html字符串为例，将html字符串作为参数传入
 api.setParallelLabelStyle('<h5>自定义并行加签文字内容</h5>')

代码示例

// setParallelLabelStyle()
export default class Plugin {
    apply() {
        return [
            {
                event: 'approval.agree.render.after',
                functional: this.approvalAgreeRenderafter.bind(this)
            }
        ]
    }

    approvalAgreeRenderafter(api) {
        api.setParallelLabelStyle('<h5>自定义并行加签文字内容</h5>')
    }
}

三、setSerialLabelStyle

功能描述

用户可以自定义设置串行加签的文字内容。

参数

参数说明类型
Dom对象/html字符串自定义设置文字内容和样式Object/String
false隐藏串行加签文字内容Boolean

注：不传参数，表示使用默认标题

返回结果

无

参数代码示例

// 以html字符串为例，将html字符串作为参数传入
 api.setSerialLabelStyle('<h5>自定义串行加签文字内容</h5>')

代码示例

// setSerialLabelStyle()
export default class Plugin {
    apply() {
        return [
            {
                event: 'approval.agree.render.after',
                functional: this.approvalAgreeRenderAfter.bind(this)
            }
        ]
    }

    approvalAgreeRenderAfter(api) {
        api.setSerialLabelStyle('<h5>自定义串行加签文字内容</h5>')
    }
}

四、setDialogTitle

功能描述

用户可以自定义审批弹窗标题内容区域。

参数

参数说明类型
Dom对象/html字符串自定义设置文字内容和样式Object/String

注：不传参数，表示使用默认标题

返回结果

无

参数代码示例

// 以html字符串为例，将html字符串作为参数传入
 api.setDialogTitle('<h5>这是一段HTML代码</h5>')

代码示例

// setDialogTitle()
export default class Plugin {
    apply() {
        return [
            {
                event: 'approval.agree.render.after',
                functional: this.approvalAgreeRenderAfter.bind(this)
            }
        ]
    }

    approvalAgreeRenderAfter(api) {
        api.setDialogTitle('<h5>这是一段HTML代码</h5>') // 标题替换为 "这是一段HTML代码"
    }
}

五、showAfterAddSign

功能描述

用户可以自定义控制后加签功能的隐藏和展示。

参数

参数说明类型
true显示后加签功能Boolean
false隐藏后加签功能Boolean

返回结果

无

参数代码示例

// 传入false，表示隐藏后加签功能
api.showAfterAddSign(false)
// 传入true，表示展示后加签功能
api.showAfterAddSign(true)

代码示例

// showAfterAddSign()
export default class Plugin {
    apply() {
        return [
            {
                event: 'approval.agree.render.after',
                functional: this.approvalAgreeRenderAfter.bind(this)
            }
        ]
    }

    approvalAgreeRenderAfter(api) {
        // api.showAfterAddSign(true) // 显示后加签
        api.showAfterAddSign(false) // 隐藏后加签
    }
}

六、setOpinionLabel

功能描述

用户可以自定义审批意见输入框标题区域，对内容或样式进行定制等操作。

参数

参数说明类型
Dom对象/html字符串自定义审批意见输入框标题内容样式Object/String

注：不传参数，表示使用默认标题

返回结果

无

参数代码示例

// 以html字符串为例，将html字符串作为参数传入
api.setOpinionLabel('<h5>自定义审批意见输入框标题</h5>')

代码示例

// setOpinionLabel()
export default class Plugin {
    apply() {
        return [
            {
                event: 'approval.agree.render.after',
                functional: this.approvalAgreeRenderAfter.bind(this)
            }
        ]
    }

    approvalAgreeRenderAfter(api) {
        api.setOpinionLabel("<h5>自定义审批意见输入框标题</h5>")
    }
}

七、setSwitchLabel

功能描述

用户可以自定义设置审批内容表单/页面，【是否同时处理审批】区域的内容。

参数

参数说明类型
Dom对象/html字符串自定义设置文字内容和样式Object/String
false隐藏处理审批label文案Boolean

注：不传参数，表示使用默认标题

返回结果

无

参数代码示例

// 以html字符串为例，将html字符串作为参数传入
api.setSwitchLabel('<h5>同时处理审批</h5>')

代码示例

// setSwitchLabel()
export default class Plugin {
    apply() {
        return [
            {
                event: 'approval.agree.render.after',
                functional: this.approvalAgreeRenderAfter.bind(this)
            }
        ]
    }

    approvalAgreeRenderAfter(api) {
        api.setSwitchLabel('<h5>同时处理审批</h5>')
        // api.setSwitchLabel(false) // 隐藏处理审批label文案
    }
}

八、showSwitchContent

功能描述

用户可以自定义控制审批内容表单/页面，隐藏【处理审批】开关容器+label文案

参数

参数说明类型
false隐藏处理审批开关容器+label文案Boolean

返回结果

无

参数代码示例

// showSwitchContent()
export default class Plugin {
    apply() {
        return [
            {
                event: 'approval.agree.render.after',
                functional: this.approvalAgreeRenderAfter.bind(this)
            }
        ]
    }

    approvalAgreeRenderAfter(api) { 
        api.showSwitchContent(false) // 隐藏处理审批开关容器+label文案
    }
}

九、showSwitchContainer

功能描述

用户可以自定义控制审批内容表单/页面，隐藏【处理审批】开关容器

参数

参数说明类型
false隐藏处理审批开关容器Boolean

返回结果

无

参数代码示例

// showSwitchContainer()
export default class Plugin {
    apply() {
        return [
            {
                event: 'approval.agree.render.after',
                functional: this.approvalAgreeRenderAfter.bind(this)
            }
        ]
    }

    approvalAgreeRenderAfter(api) {
        api.showSwitchContainer(false) // 隐藏处理审批开关容器
    }
}

十、forceSwitchContainer

功能描述

用户可以自定义控制审批内容表单/页面，强制打开/关闭 处理审批开关

参数

参数说明类型
true强制打开Boolean
false强制关闭Boolean

返回结果

无

参数代码示例

// forceSwitchContainer()
export default class Plugin {
    apply() {
        return [
            {
                event: 'approval.agree.render.after',
                functional: this.approvalAgreeRenderAfter.bind(this)
            }
        ]
    }

    approvalAgreeRenderAfter(api) {
        api.forceSwitchContainer(true) // 强制打开处理审批开关
        // api.forceSwitchContainer(false) // 强制关闭处理审批开关
    }
}