1.14 有参数数据接口辅助二级联动

通过有参数数据接口实现省市二级联动的筛选与填写。

1. 前言

在填写表单时,经常遇到需要选择地区信息的情况。比如选了"广东省"之后,市的下拉列表只显示广东省下面的市,而不是全国所有的市。这就是"二级联动"——上级的选择决定了下级的数据范围。
如果不用参数,你可能需要把全国所有市都列出来让用户自己翻,数据量大且容易选错。本教程讲解如何通过有参数数据接口,将上级选中的值作为参数传入数据接口,实现二级联动的效果。

2. 操作步骤

(1)设置数据接口

首先需要准备两个数据接口:一个用于获取省份列表(无参数),一个用于根据省份获取市列表(有参数)。
① 在省市区模板中新建一个下拉列表数据接口,命名为"省份列表",数据表选择本模板,取值选择"城市"。
② 再新建一个下拉列表数据接口,命名为"市列表"。数据表选择本模板,取值选择"城市"。
③ 在"市列表"数据接口中,点击"添加参数",参数名称设为"省份",类型选择"文本"。
④ 设置过滤条件:本模板的"省份"字段 等于 参数"省份"。

(2)绑定参数到下拉列表

目标: 在表单中设置下拉列表,将选中的省份作为参数传入市列表。
① 在模板中添加"省份"下拉列表,数据接口选择"省份列表"。
② 再添加"市"下拉列表,数据接口选择"市列表"。在参数绑定中,将"省份"参数绑定到表单中的"省份"字段。
使用效果: 选择省份后,再点击市下拉列表,此时列表中只显示该省份下的市。

3. 核心要点回顾

(1)二级联动依赖于有参数数据接口,上级的值作为参数传入下级的过滤条件。
(2)需要先创建无参数的数据接口获取上级数据,再创建有参数的数据接口获取下级数据,并在设计接口时直接添加参数和过滤条件。
(3)在下级下拉列表中绑定参数时,将参数来源指向表单中上级的字段。
2026-07-15
0 0