# 联动选项控件

在登记表单中根据已选的部门、地区或产品大类缩小第二级选项。

## 放置与配置

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

| 参数标识 | 类型 | 标准场景 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `dataListId` | 变量或表达式 | 需要 | 数据列表 ID。来源数据列表的 ID。 | `203...` |
| `parentField` | 变量或表达式 | 需要 | 上级字段。保存上级选项的来源字段标识。 | `Country` |
| `childField` | 变量或表达式 | 需要 | 下级选项字段。保存下级选项的来源字段标识。 | `State` |
| `parentSaveToField` | 变量或表达式 | 需要 | 上级选项保存目标。用于写入上级选项的字段或变量。 | `SelectedCountry` |
| `childSaveToField` | 变量或表达式 | 需要 | 下级选项保存目标。用于写入下级选项的字段或变量。 | `SelectedState` |
| `titleText` | 文本 | 按需 | 标题。显示在控件顶部的主标题。 | `地区选择` |
| `subtitleText` | 文本 | 按需 | 副标题。显示在主标题下方的说明。 | `选择国家及省市` |
| `maxItems` | 文本 | 按需 | 最大条数。最多保留的来源记录数。 | `500` |
| `emptyText` | 文本 | 按需 | 空状态提示。没有可展示数据时的提示文案。 | `暂无可选项` |
| `filterExpression` | 变量或表达式 | 按需 | 查询筛选条件。可选的列表查询条件。 | 按需留空 |

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

1. 准备两级选项来源。
2. 映射两个选项字段。
3. 绑定两处可写保存目标。

## 业务示例与结果

仓储表单先选「华东」，下级只显示「上海库」「苏州库」。切换到「华南」时，之前选中的仓库会清空。

上下级选项分别写为文本。切换上级立即清空下级保存目标。控件读取现有值，只读时禁用两个选择框。

来源列表需授予使用者读取权限。控件读取查询返回的首批记录，再按配置筛选、排序或截取。数据量较大时，按目标租户的 SDK 筛选格式缩小查询范围。

## 预览验收

确认选择列表去重、切换上级清空下级、重开后回显、只读禁用和空数据提示。

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

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

源模板 CCT9A385。 [Yeeflow 原站控件](https://www.yeeflow.com/templates/custom-code/dependent-selector)