Cascader 级联选择
WebH5
级联选择器。多列面板逐级展开嵌套选项,点击叶子选中整条路径;触发器以 / 连接显示路径,支持清空、点外部与 Escape 关闭。multiple 开启多选:面板项显示复选框级联勾选,触发器以标签展示选中叶子,支持 collapseTags 折叠。
何时使用
从层级数据中选取一条路径:省市区、多级分类、组织层级。
何时不使用
需要同时看到并勾选多个层级节点时,用 Tree。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | Array<string | number> | Array<Array<string | number>> | [] | 选中路径(单选)或选中路径数组(multiple 多选),配合 v-model 使用 |
options | Array<CascaderOption> | [] | 嵌套选项,项为 { label: string; value: string | number; children?: 同构; disabled?: boolean } |
placeholder | string | "请选择(取 locale 文案 cascader.placeholder)" | 未选中时的占位文本 |
disabled | boolean | false | 禁用 |
clearable | boolean | false | 可清空;有值时 hover 触发器显示清空按钮 |
multiple | boolean | false | 多选模式:面板项显示复选框,勾选父级级联勾选全部可选子孙(部分选中时父级半选);点复选框勾选且面板不关闭,点 label 文本展开子列;modelValue 为路径数组 |
collapseTags | boolean | false | 多选时折叠标签:只显示首个标签与 +N 计数 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | Array<string | number> | Array<Array<string | number>> | 选中叶子/勾选变化/清空时触发,用于 v-model |
change | Array<string | number> | Array<Array<string | number>> | 值变化时触发(选中叶子、勾选变化或清空) |
clear | void | 点击清空按钮时触发 |
示例
基础(省市区)
示例加载中…
可清空与禁用叶子
示例加载中…
组织层级
示例加载中…
多选(选择负责部门)
示例加载中…
禁用态
示例加载中…
事件监听
示例加载中…
业务场景:订单发货地
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Cascader 文档(含手机预览)。