简介
级联选择组件是一种允许用户从多个层级中逐步选择选项的组件,每个选择都会影响下一个选择的可用选项,常用于区域、分类等具有层次关系的数据选择场景。

配置项
分类 | 配置 | 示例 | 说明 |
内容 | 选项列表 |
| 级联选择组件的数据源,层级最高支持4层。 |
默认值 |
| 默认值要求每一层级的值都必须包含,并且要与选项顺序一一对应。 | |
展位内容 |
| 没有选择任何选项时显示的提示文本。 | |
标签 |
| 详情参见表单通用属性 | |
交互 | 隐藏 |
| 控制级联选择组件的默认展示状态,为 |
禁用 |
| 是否禁用级联选择组件 | |
支持清除 |
| 是否支持清除级联选择的值 | |
显示搜索框 |
| 是否支持搜索过滤数据源 | |
校验 |
| 详情参见表单通用属性 | |
样式 | 外边距 |
| 详情参见通用属性 |
形态变体 |
| 级联选择组件的输入框形态。 | |
选项选中时背景色 |
| 选项选中时背景颜色。 | |
标签字体大小 |
| 仅对标签文字内容生效。 |
属性与方法
名称 | 类型 | 示例 | 说明 |
value | array |
| 当前级联选择组件的选中内容 |
options | array |
| 只读,当前级联选择组件的数据源 |
disabled | boolean |
| 是否禁用当前级联选择组件 |
showSearch | boolean |
| 是否支持搜索过滤级联选择组件的数据源 |
allowClear | boolean |
| 是否支持清除级联选择组件的值 |
hidden | boolean |
| 当前组件是否隐藏 |
setValue | func |
| 设置级联选择的选中值为 |
clearValue | func |
| 清除级联选择的选中值 |
setDIsabled | func |
| 设置级联选择的是否禁用,参数为 |
clearDIsabled | func |
| 清除级联选择的禁用状态 |
setAllowClear | func |
| 设置级联选择的值是否支持清除,参数为 |
clearAllowClear | func |
| 清除级联选择的支持清除状态 |
setShowSearch | func |
| 设置级联选择的值是否支持过滤数据源,参数为 |
clearShowSearch | func |
| 清除级联选择的支持过滤状态 |
setHidden | func |
| 设置级联选择是否隐藏,参数为 |
事件回调
配置 | 说明 |
| 当级联选择的选中值发生变化时将触发的事件 |
场景示例
地址场景
在级联选择的数据源中配置各个省份的信息,在收集用户信息/商品下单场景下,可以让用户快速填写地址。















