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

在 Vue 3 中实现级联菜单(如省市区三级联动)的 `v-model` 绑定,核心是让自定义级联组件支持标准的 `v-model` 语法糖:即接收 `modelValue` prop、触发 `update:modelValue` 事件,并确保数据结构与业务逻辑匹配。 以下分三部分说明关键实现要点:
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 的 原生支持 Vue 3 的 v-model,无需额外封装即可双向绑定:
-
selectedCode是响应式数组(如ref(['440000', '440300'])),会自动同步选中状态 - 数据源
areaOptions需符合{ value, label, children }结构,且 children 可异步加载
3. 封装通用级联组件时注意父子通信一致性
若自行封装(如 ),除基础 v-model 外,还需处理:
-
清空逻辑:点击清空按钮时,应触发
update:modelValue并传入空数组或 null -
禁用联动:通过
:props="{ checkStrictly: true }"或控制子级 options 加载时机来实现 -
多级回显:编辑页面赋值时,确保传入的
modelValue能在数据源中逐级匹配到对应节点(否则显示为空) - 从 Vue 3.4 起可改用
defineModel()宏简化写法:const model = defineModel(),然后直接操作model.value
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










