Cascader 级联选择器

规则

基础示例

Props 配置示例

整段禁用

尺寸对比（迷你 / 小 / 中）

Events 示例

Props

名称	类型	默认值	说明
before-filter	(value: string) => boolean | Promise	—	筛选之前的钩子，参数为输入的值，若返回 false 或者返回 Promise 且被 reject，则停止筛选
blank	boolean	false	shape='filter' 时生效，设置过滤器模式背景为透明
clearable	boolean	false	是否支持清空选项
collapse-tags	boolean	false	多选模式下是否折叠 Tag
debounce	number	300	搜索关键词输入的去抖延迟，单位毫秒
disabled	boolean	false	是否禁用
filter-method	(node: ICascaderPanelNode, keyword: string) => boolean	—	自定义搜索逻辑
filterable	boolean	—	是否可搜索选项
label	string	—	shape='filter' 时生效，可传入 label 显示标题
modelValue / v-model	ICascaderPanelNodePropValue	—	选中项绑定值，其类型由 props.multiple、props.emitPath 共同决定
options	ICascaderPanelData[]	—	可选项数据源，键名可通过 Props 属性配置
placeholder	string	'请选择'	输入框占位文本
popper-append-to-body	boolean	true	是否将弹出框插入至 body 元素
popper-class	string	—	为 popper 添加类名
props	ICascaderPanelConfig	—	配置选项，具体见 ICascaderPanelConfig 表
separator	string	'/'	选项分隔符
shape	'filter'	—	通过 shape='filter' 属性切换至过滤器模式
show-all-levels	boolean	true	输入框中是否显示选中值的完整路径
size	'medium' | 'small' | 'mini'	—	尺寸
tip	string	—	shape='filter' 时生效，可传入 tip 显示提示信息

Events

名称	类型	说明
blur	(event: FocusEvent) => void	当失去焦点时触发
change	(value: ICascaderPanelNodePropValue) => void	当选中节点变化时触发
expand-change	(value: ICascaderPanelNodeValue[]) => void	当展开节点发生变化时触发
focus	(event: FocusEvent) => void	当获得焦点时触发
remove-tag	(removeValue: ICascaderPanelNodeValue[]) => void	在多选模式下，移除Tag时触发
visible-change	(visible: boolean) => void	下拉框出现/隐藏时触发