简介
级联选择组件是一种允许用户从多个层级中逐步选择选项的组件,每个选择都会影响下一个选择的可用选项,常用于区域、分类等具有层次关系的数据选择场景。
配置项
分类 | 配置 | 示例 | 说明 |
内容 | 选项列表 | 级联选择组件的数据源,层级最高支持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 |
| 设置级联选择是否隐藏,参数为 |
事件回调
配置 | 说明 |
当级联选择的选中值发生变化时将触发的事件 |
场景示例
地址场景
在级联选择的数据源中配置各个省份的信息,在收集用户信息/商品下单场景下,可以让用户快速填写地址。