# 合规核对清单控件

在提交或审核前逐项核对制度、内控、资料和操作条件。

## 放置与配置

在易企办测试应用中打开审批表单或支持自定义代码控件的页面，添加自定义代码控件，将同目录 TSX 完整粘贴到编辑器。先核对位置、字段类型与读写权限，再配置下表。

| 参数标识 | 类型 | 标准场景 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `itemsJson` | 变量或表达式 | 需要 | 检查项 JSON。包含检查项定义的 JSON 数组。 | `[{"id":"policy","label":"已核对制度要求","required":true,"helper":"对照现行制度版本"},{"id":"archive","label":"已整理附件","required":false}]` |
| `saveToField` | 变量或表达式 | 需要 | 保存目标。保存结果的可写字段或变量。 | `ChecklistJson` |
| `requireAllChecked` | 变量或表达式 | 按需 | 提示必查项未完成。未勾选全部必查项时显示提醒。 | `true` |
| `showProgress` | 变量或表达式 | 按需 | 显示进度条。显示检查项的完成进度。 | `true` |
| `titleText` | 文本 | 按需 | 标题。显示在控件顶部的主标题。 | `合规核对清单` |
| `subtitleText` | 文本 | 按需 | 副标题。显示在主标题下方的说明。 | `请在提交前确认` |
| `emptyText` | 文本 | 按需 | 空状态提示。没有可展示数据时的提示文案。 | `暂无已配置的检查项` |

示例字段和列表 ID 请替换为目标应用的实际值。表达式请在编辑器中绑定。保存目标使用可写文本字段或环境支持的可写变量。

1. 定义检查项和必查标记。
2. 绑定可写文本字段。
3. 验证提醒及保存结果。

## 业务示例与结果

供应商准入时确认已核对资质、已核对审批权限。附件整理可标记为非必查。

每次修改保存 JSON 数组，例如 `[{"id":"policy","label":"已核对制度要求","checked":true,"required":true}]`。在只读页面可查看已保存的勾选。必查开关控制控件内提醒，流程的提交阻断需在表单或工作流配置。

## 预览验收

核对必查项未完成提醒、进度条、重新打开时的勾选回显以及只读状态。

出现空结果时，先核对参数值、来源数据、字段标识和使用者权限。涉及写回时，再检查可写目标类型、当前页面权限及保存后的实际值。

模板已做本地源码与交互检查。发布到业务环境前，请在目标易企办租户验证当前版本的控件编辑器、数据权限和实际读写。

源模板 CCT3D5A3。 [Yeeflow 原站控件](https://www.yeeflow.com/templates/custom-code/checklist-compliance-block)