项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。
仅桌面端保证样式

Cascader 级联选择 ​

多级层级数据的单选/多选选择器:按列展开逐级选择,支持搜索、清空、多选标签与自定义字段名。

基础用法 ​

请选择省 / 市 / 区

选中值:[]

可搜索 ​

filterable 开启后可输入关键字过滤候选(按节点 label 匹配):

输入「杭州」试试

多选 ​

multiple 开启后以标签展示选中路径,可单个移除;collapse-tags 折叠超出标签为 +N:

可多选

选中:[]

懒加载 ​

lazy + load-data 按需拉取子级:选项只需声明 leaf: false,展开该节点时才调用加载函数,期间该列展示加载态;load-data(option) 返回 Promise,子级在 option.children 就地写入(或直接由 Promise 返回)后并入面板:

懒加载选择区域

选中值:[]

禁用与清空 ​

禁用状态
浙江省 / 杭州市 / 西湖区

键盘操作 ​

触发器聚焦后 Enter / ↓ 打开面板、Esc 关闭;面板打开时 ↑ / ↓ 在当前列选项间移动高亮,→ 展开高亮节点进入子列、← 回退上一列,Enter 选中可选节点。键盘高亮展开不依赖 hover 模式(expand-trigger="hover" 下同样有效),禁用项会被自动跳过。

Cascader API ​

名称类型默认值说明
modelValueArray / String / Number—选中值路径(v-model)
optionsArray[]层级数据 { value, label, children }
multipleBooleanfalse多选
collapse-tagsBooleanfalse多选时超出数量的标签折叠为 +N
clearableBooleantrue可清空
filterableBooleanfalse可搜索
filter-methodFunction—自定义过滤 (node, query) => boolean
disabledBooleanfalse禁用
propsObject{}自定义字段名 { label, value, children }
lazyBooleanfalse懒加载开关(配合 load-data)
load-dataFunctionnull懒加载函数 (option) => Promise,展开 leaf 为 false 且无 children 的节点时调用,子级并入后可继续逐级选择
rippleBooleantrue激活涟漪动效开关:聚焦时实体色影向内收拢消散;也可在 Form 上批量关闭或全局 setRipple(false)

事件:change(value)、visible-change(visible)、clear。