审批流
审批流组件用于在页面中展示某条数据的审批进度(审批详情),常用于详情页中展示当前单据的流转状态与处理记录。
概述
将「审批流」拖入画布后,组件会在运行态根据页面上下文中的审批流实例 ID(workflowDataId)与数据 ID 渲染审批详情。
- 编辑器中展示一个步骤条示意图,用于占位预览;实际内容在用户态渲染。
- 可配置标题与禁用内置操作区;禁用后不显示组件内置的审批操作按钮,适合由 审批流操作 组件统一承载操作按钮的场景。
- 可开启简洁模式(折叠视图 / 紧凑展示):默认仅展示当前所处节点,通过「查看全部」展开完整流程。
配置项
| 配置项 | 说明 |
|---|---|
| 标题 | 审批详情的标题,拖入画布时默认为「审批流程」 |
| 禁用内置操作区 | 开启后隐藏组件内置的审批操作按钮 |
| 简洁模式 | 开启后默认仅展示当前节点,可展开查看全部节点 |
简洁模式
开启「简洁模式」后,运行态默认以一张紧凑卡片展示对用户最有价值的当前节点:
- 卡片内部第一行:左侧为标题,右侧为「查看全部 (N)」链接(N 为节点总 数)。
- 中间为当前节点信息:节点图标(橙色感叹号)、节点名称、待x人审核标签(主题色,展示该节点待审批人数,无待审人数时不显示)与节点状态标签。
- 底部为进度摘要:「已完成 X 个节点 · 后续 Y 个节点未执行」与当前节点审批时间。
- 简洁模式下不展示审批操作按钮(同意 / 驳回等),也不展示「查看记录」入口;需要操作时可展开查看。
- 点击「查看全部 (N)」打开独立推屏:上半部分为完整流程时间线(审批操作按钮按「禁用内置操作区」开关展示),下半部分直接展示审批记录明细,无需再单独点击查看。
- 审批已结束(通过 / 驳回 / 退回 / 撤回)的流程,卡片展示最后一个业务节点的状态。
提示
简洁模式仅影响展示形态,不影响审批操作与数据上下文依赖;未开启时始终展示完整时间线。
数据来源与上下文依赖
- 组件自身不存储审批数据,运行时依赖页面上下文中的审批流实例 ID(优先取上下文
currentData的workflowdataid字段,其次取workflowDataId)与数据 ID 渲染审批进度。 - 开启「禁用内置操作区」后,审批详情中的操作入口被隐藏,需由 审批流操作 组件提供动作按钮,便于统一控制按钮的位置与样式。
使用建议
- 详情页中通常将本组件与 审批流操作 搭配:本组件负责展示进度,操作组件负责承接同意 / 驳回等动作。
- 页面上下文中必须包含审批流实例 ID,才能正常渲染。
下一步
属性明细
以下内容面向技术实现与 AI 检索。组件所有 meta 值均以字符串形式存储在 WidgetItem.meta 中。
组件属性(meta)
| 属性名 | 类型 | 含义 | 取值/存储值 |
|---|---|---|---|
Title | string | 审批详情标题 | 展示文本;拖入画布时默认为「审批流程」 |
DisableInternalActions | string(boolean) | 是否禁用内置操作区 | true / false(默认) |
CompactMode | string(boolean) | 是否开启简洁模式 | true / false(默认) |
组件固定 uid:0e89a093-4b8f-4234-8951-8f5cdfbcfc61。运行态读取 meta.Title 作为标题,meta.DisableInternalActions === 'true' 时禁用内置操作,meta.CompactMode === 'true' 时默认以简洁卡片展示当前节点;审批流实例 ID 与数据 ID 均由 cmpParams 解析。
存储示例
完整 WidgetItem:
{
"id": "9b0c1d2e-3f4a-4b5c-8d6e-7f8a9b0c1d2e",
"uid": "0e89a093-4b8f-4234-8951-8f5cdfbcfc61",
"dragType": "Widget",
"originalType": "Widget",
"widgetType": "MetaWorkflow",
"widgetTypeName": "审批流",
"meta": {
"Title": "审批流程",
"DisableInternalActions": "false",
"CompactMode": "false"
},
"children": []
}
嵌套在「基础容器(Row)> 布局列组件(Column)」中的完整位置示例:
{
"id": "3f9c1a2b-4d5e-4f60-8a71-9b2c3d4e5f60",
"uid": "5a0f3c1e-9b8d-4f6a-9c2e-7d1b4a8e6f3d",
"dragType": "Row",
"originalType": "Row",
"widgetType": "Row",
"widgetTypeName": "基础容器",
"meta": { "ColumnSpace": "5" },
"children": [
{
"id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
"uid": "7b9a905e-83d4-452b-83c8-694a3e0935e3",
"dragType": "Column",
"originalType": "Column",
"widgetType": "Column",
"widgetTypeName": "布局列组件",
"meta": { "LayoutType": "vertical", "Align": "default", "ItemSpace": "5" },
"children": [
{
"id": "9b0c1d2e-3f4a-4b5c-8d6e-7f8a9b0c1d2e",
"uid": "0e89a093-4b8f-4234-8951-8f5cdfbcfc61",
"dragType": "Widget",
"originalType": "Widget",
"widgetType": "MetaWorkflow",
"widgetTypeName": "审批流",
"meta": {
"Title": "审批流程",
"DisableInternalActions": "true",
"CompactMode": "true"
},
"children": []
}
]
}
]
}
相关接口
本组件通过页面上下文(cmpParams)解析审批流实例 ID 与数据 ID,无需额外配置接口。