Vue 3级联菜单v-model绑定需接收modelValue prop并触发update:modelValue事件;Element Plus Cascader原生支持;自封装组件需处理清空、禁用联动及多级回显,Vue 3.4+可用defineModel简化。

1. 级联组件需正确声明 v-model 接口
组件内部不能用 value 作为 prop 名,必须使用 modelValue;选择变化后,通过 $emit('update:modelValue', newValue) 通知父组件更新。
- prop 定义示例:
modelValue: { type: Array, default: () => [] }(适用于返回路径数组,如['广东省', '深圳市', '南山区']) - 或更常见的是返回编码数组:
['440000', '440300', '440305'],便于后端识别 - 若需回显编辑,确保传入的初始值格式与组件期望一致(否则无法高亮选中项)
2. 使用 Element Plus 的 Cascader 时直接绑定 v-model
Element Plus 的 <el-cascader></el-cascader> 原生支持 Vue 3 的 v-model,无需额外封装即可双向绑定:
<el-cascader v-model="selectedCode" :options="areaOptions"></el-cascader>-
selectedCode是响应式数组(如ref(['440000', '440300'])),会自动同步选中状态 - 数据源
areaOptions需符合{ value, label, children }结构,且 children 可异步加载
3. 封装通用级联组件时注意父子通信一致性
若自行封装(如 <area-cascader></area-cascader>),除基础 v-model 外,还需处理:
-
清空逻辑:点击清空按钮时,应触发
update:modelValue并传入空数组或 null -
禁用联动:通过
:props="{ checkStrictly: true }"或控制子级 options 加载时机来实现 -
多级回显:编辑页面赋值时,确保传入的
modelValue能在数据源中逐级匹配到对应节点(否则显示为空) - 从 Vue 3.4 起可改用
defineModel()宏简化写法:const model = defineModel(),然后直接操作model.value


















