模板说明
在登记表单中根据已选的部门、地区或产品大类缩小第二级选项。
使用场景
仓储表单先选「华东」,下级只显示「上海库」「苏州库」。切换到「华南」时,之前选中的仓库会清空。
运行结果
上下级选项分别写为文本。切换上级立即清空下级保存目标。控件读取现有值,只读时禁用两个选择框。
来源列表需授予使用者读取权限。控件读取查询返回的首批记录,再按配置筛选、排序或截取。数据量较大时,按目标租户的 SDK 筛选格式缩小查询范围。
验收步骤
确认选择列表去重、切换上级清空下级、重开后回显、只读禁用和空数据提示。
查看完整控件源码(TSX)
中文配置参考
控件参数与连接
| 参数标识 | 类型 | 标准场景 | 说明 | 示例 |
|---|---|---|---|---|
dataListId | 变量或表达式 | 需要 | 数据列表 ID。来源数据列表的 ID。 | 203... |
parentField | 变量或表达式 | 需要 | 上级字段。保存上级选项的来源字段标识。 | Country |
childField | 变量或表达式 | 需要 | 下级选项字段。保存下级选项的来源字段标识。 | State |
parentSaveToField | 变量或表达式 | 需要 | 上级选项保存目标。用于写入上级选项的字段或变量。 | SelectedCountry |
childSaveToField | 变量或表达式 | 需要 | 下级选项保存目标。用于写入下级选项的字段或变量。 | SelectedState |
titleText | 文本 | 按需 | 标题。显示在控件顶部的主标题。 | 地区选择 |
subtitleText | 文本 | 按需 | 副标题。显示在主标题下方的说明。 | 选择国家及省市 |
maxItems | 文本 | 按需 | 最大条数。最多保留的来源记录数。 | 500 |
emptyText | 文本 | 按需 | 空状态提示。没有可展示数据时的提示文案。 | 暂无可选项 |
filterExpression | 变量或表达式 | 按需 | 查询筛选条件。可选的列表查询条件。 | 按需留空 |