地区选择

中国行政区域级联选择。

概念说明

属性

组件通用属性请参见组件通用说明。

地区选择

• 数据：支持动态绑定集合类型变量（List<T>）或输出参数为集合类型的逻辑。
• 数据类型：该属性为只读状态，当数据源动态绑定集合List<T>后，会自动识别T的类型并进行展示。
• 选择框占位符：选择框无内容时的提示信息，支持自定义编辑，默认为请选择。
• 触发方式：地区选择时下一层级的展开方式，可以点击展开或者鼠标悬浮时展开。
• 值：当前选择的值。
• 转换器：选择地区名称，返回示例：浙江省/杭州市/滨江区（不加空格）；选择地区码，返回：330108。
• 文本字段：集合的元素类型中，用于显示文本的属性名称，支持自定义变更。
• 可筛选：开启后选择框可输入文本进行筛选。
• 可清空：控制是否显示清除按钮，支持一键清除所选内容。
• 只显示最后一项：控制选择地区项后输入框里展示的形式，开启时只展示最后一项目，未开启时展示所有项路径。默认关闭。
• 禁用：置灰显示，且禁止任何交互（焦点、点击、选择、输入等）。
• 弹出状态：开启时加载下拉框时，下拉框自动弹出，默认关闭。
• 自动获取焦点：控制是否在进入页面时聚焦到该组件。

事件

• 地区选择组件支持鼠标事件和组件事件。

  • 鼠标事件

    事件名	触发条件
    获取焦点	鼠标点中组件聚焦时
    失去焦点	鼠标指针点击其他区域，组件失去焦点时

  • 组件事件

    事件名	触发条件
    输入时	当输入框里输入数据时
    选择后	下拉项选择后
    清空后	点击清除按钮清除数据后

样式

样式说明请参见组件通用说明。

地区选择内置逻辑

• open：打开下拉选择弹窗。
• close：关闭下拉选择弹窗。
• clear：清除选择框数据。