Skip to content

Cascader 级联选择器

当一个数据集合有清晰的层级结构时,可通过级联选择器逐级查看并选择。

TIP

在 SSR 场景下,您需要将组件包裹在 <client-only></client-only> 之中 (如: Nuxt) 和 SSG (eg: VitePress).

基础用法

基本配置做了修改: 开启清空 | 开启过滤 | 取消父子关联 | 选中值只返回节点的id | value: 'id' | label: 'title'

指定options选项item的value值类型

通过isKeyNumber 指定item的value值类型 是number类型还是字符串类型 可以 让v-model绑定的数据 适应对应value值的类型 默认false

多选情况下 v-model绑定值的 2种类型

全选子集按钮

如果是存在子集children的情况下 默认显示 全选子集按钮 可以通过showSelectAllBtn来控制

全选子集时 是否递归

全选子集 默认递归 可以通过isDeepSelect来控制

单选情况下 不显示radio控件

可以通过showRadioControl来控制

Cascader API

Cascader Attributes

NameDescriptionTypeDefault
model-value / v-model绑定值string[] | number[] | any
options选项的数据源-同element-plus, valuelabel 可以通过 CascaderProps自定义.object
props配置选项-同element-plus 默认配置object
isKeyNumberoptions选项item的value 值 是否是 number 如果不是就默认字符串Booleanfalse
dataType多选情况下 => v-model绑定值的类型 String: '1,2,3'Array: [2,3,4] 两种enum'String'
showSelectAllBtn是否显示全选子集按钮Booleantrue
showRadioControl单选情况下是否显示radio控件 => 内置了默认自定义样式 单选情况下不显示radio控件Booleanfalse
...其他参数同element-plus

Cascader Events 事件

贡献者

Released under the MIT License.