# 多项标签输入控件

为申请、工单或物料配置连续录入多个收件人、关键词或编码。

## 放置与配置

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

| 参数标识 | 类型 | 标准场景 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `saveToField` | 变量或表达式 | 需要 | 保存目标。保存多个标签的可写文本字段或变量。 | `TagsJson` |
| `titleText` | 文本 | 按需 | 标题。显示在控件顶部的主标题。 | `收件人` |
| `subtitleText` | 文本 | 按需 | 副标题。显示在主标题下方的说明。 | `按回车添加每一项` |
| `placeholderText` | 文本 | 按需 | 输入提示。输入框中的提示文字。 | `输入邮箱后按回车添加` |
| `maxTags` | 文本 | 按需 | 最大标签数。允许保存的标签数量上限。 | `20` |
| `allowDuplicates` | 变量或表达式 | 按需 | 允许重复。开启后保留重复的输入值。 | `false` |
| `saveMode` | 文本 | 按需 | 保存格式。使用 json 保存数组，使用 delimiter 保存分隔文本。 | `json` |
| `delimiter` | 文本 | 按需 | 分隔符。以分隔文本保存时使用的字符。 | `,` |
| `emptyText` | 文本 | 按需 | 空状态提示。没有可展示数据时的提示文案。 | `暂无标签` |

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

1. 绑定标签保存目标。
2. 选择格式及数量上限。
3. 验证录入、移除和回显。

## 业务示例与结果

为工单加上「设备」「报修」「需上门」三个标签，每项输入完成后按一次回车。

默认保存 JSON 文本，例如 `["设备","报修"]`。切换到 `delimiter` 后保存分隔文本。分隔符应避开实际输入值。默认按不区分大小写的规则去重。控件保存文本标签，可在业务字段或流程中另行校验邮箱格式。

## 预览验收

验证中文输入法选词、回车新增、移除、重复值、最大数量、重新加载及只读查看。

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

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

源模板 CCT90268。 [Yeeflow 原站控件](https://www.yeeflow.com/templates/custom-code/multi-entry-tag-input)