跳到主要内容

Cascader 级联选择 ​

WebH5

级联选择器。多列面板逐级展开嵌套选项,点击叶子选中整条路径;触发器以 / 连接显示路径,支持清空、点外部与 Escape 关闭。multiple 开启多选:面板项显示复选框级联勾选,触发器以标签展示选中叶子,支持 collapseTags 折叠。

何时使用 ​

从层级数据中选取一条路径:省市区、多级分类、组织层级。

何时不使用 ​

需要同时看到并勾选多个层级节点时,用 Tree。

Props ​

名称类型默认值说明
modelValueArray<string | number> | Array<Array<string | number>>[]选中路径(单选)或选中路径数组(multiple 多选),配合 v-model 使用
optionsArray<CascaderOption>[]嵌套选项,项为 { label: string; value: string | number; children?: 同构; disabled?: boolean }
placeholderstring"请选择(取 locale 文案 cascader.placeholder)"未选中时的占位文本
disabledbooleanfalse禁用
clearablebooleanfalse可清空;有值时 hover 触发器显示清空按钮
multiplebooleanfalse多选模式:面板项显示复选框,勾选父级级联勾选全部可选子孙(部分选中时父级半选);点复选框勾选且面板不关闭,点 label 文本展开子列;modelValue 为路径数组
collapseTagsbooleanfalse多选时折叠标签:只显示首个标签与 +N 计数

Events ​

名称载荷说明
update:modelValueArray<string | number> | Array<Array<string | number>>选中叶子/勾选变化/清空时触发,用于 v-model
changeArray<string | number> | Array<Array<string | number>>值变化时触发(选中叶子、勾选变化或清空)
clearvoid点击清空按钮时触发

示例 ​

基础(省市区) ​

示例加载中…

可清空与禁用叶子 ​

示例加载中…

组织层级 ​

示例加载中…

多选(选择负责部门) ​

示例加载中…

禁用态 ​

示例加载中…

事件监听 ​

示例加载中…

业务场景:订单发货地 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Cascader 文档(含手机预览)。