城市选择

1. 组件概述

城市选择是一个数据输入组件，专门用于选择中国的省、市、区地址。它内置了完整的中国行政区划数据，通过多级联动的下拉框让用户逐级选择地址。用户先选择省份，然后根据所选省份显示对应的城市列表，再根据所选城市显示对应的区县列表。这种级联选择的方式既保证了数据的准确性，又简化了用户的操作。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：用户信息收集。在学习平台的用户注册或个人资料页面，需要收集用户的所在地信息。使用城市选择组件，用户可以快速选择自己的省市区，无需手动输入。建议开启”可搜索”功能，方便用户快速定位。
• 场景二：活动报名表单。在线下活动或比赛的报名页面，需要收集参与者的地区信息以便统计和分组。使用城市选择组件收集地区信息，如果只需要统计到城市级别，可以关闭”可选区域”，简化用户操作。

加载中...

查看 JSON

复制 JSON

3. 功能配置

高级

基本折叠组

配置项	说明
绑定变量	组件的变量名，用户选择的地址信息会以此变量名存储。其他组件可以绑定此变量来显示地址，调用工作流时此变量的值也会传递给工作流。
标题	表单项左侧显示的标签文字，用于说明该输入项的用途，如”所在城市”、“收货地址”等。
默认值	组件的初始选中值。可以设置为静态值或绑定变量。设置后，组件加载时会自动选中对应的省市区。
值格式	控制组件存储数据的格式。有两个选项：行政编码（默认）：只存储最终选择的行政区划编码（如”110101”代表北京市东城区），数据简洁，适合大多数场景；对象结构：存储完整的地址对象，包含省份名称、省份编码、城市名称、城市编码、区域名称、区域编码等详细信息，适合需要分别使用各级地址信息的场景。
可选城市	控制是否显示城市选择下拉框。默认开启。如果只需要选择省份，可以关闭此选项。关闭后，用户只能选择省份，不会显示城市和区域的选择框。
可选区域	控制是否显示区域（区/县）选择下拉框。默认开启，仅在”可选城市”开启时可用。如果只需要选择到城市级别，可以关闭此选项。
可搜索	开启后，下拉框支持输入关键词搜索。当省份或城市较多时，用户可以直接输入名称快速定位，而不必在长列表中滚动查找。建议开启以提升用户体验。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置简短的帮助说明，如”请选择您的常住地址”。
控件提示	在输入控件旁边显示一个小问号图标，鼠标悬停时弹出提示内容。
描述	显示在组件下方的浅色说明文字，用于补充解释该配置项的用途或填写要求。

状态折叠组

配置项	说明
可见	控制组件是否显示。默认可见。
隐藏	控制组件是否隐藏。与”可见”相反。
禁用	控制组件是否禁用（变灰且不可操作）。
静态展示	开启后，组件变为只读的纯文本展示模式，不可编辑。适用于详情页或确认页面。
隐藏时删除字段	开启后，当该组件被隐藏时，其值会从表单数据中删除。适用于条件显示的字段，避免提交无关数据。

校验折叠组

配置项	说明
校验规则	可以为城市选择组件添加校验规则，如设置为必填，确保用户必须选择地址才能提交表单。

事件

事件折叠组

配置项	说明
添加事件	支持”值变化”触发事件。当用户选择或更改地址时触发。可以用于联动其他组件，例如根据用户选择的城市自动填充邮编，或者根据地区显示不同的配送说明。