Vue 3 中 v-model 支持多属性绑定,3.4+ 推荐用 defineModel('字段名') 简化双向绑定;旧版需手动声明 props/emits 并触发 update:xxx 事件;修饰符通过 modifiers 配置实现,命名须小写驼峰。

v-model 在 Vue 3 中支持同时绑定多个属性,不再局限于单一的 modelValue。核心思路是:用参数指定绑定字段名,子组件声明对应 prop 并触发 update:xxx 事件;从 Vue 3.4 起,defineModel() 宏让写法更简洁、语义更清晰。
多参数 v-model 的标准写法(推荐 Vue 3.4+)
父组件直接使用 v-model:字段名 语法,子组件用 defineModel('字段名') 声明即可实现双向绑定:
- 父组件:
- 子组件(
UserInfoForm.vue):const firstName = defineModel('firstName')<br>const email = defineModel('email')<br>const age = defineModel('age', { type: Number })每个
defineModel()返回一个可读写的 ref,修改其.value会自动触发对应事件,父组件数据实时同步。
兼容旧版本(Vue
需显式声明 props 和 emits,并手动处理事件派发:
- 子组件中定义:
defineProps({<br> firstName: String,<br> email: String,<br> age: Number<br>)<br>defineEmits(['update:firstName', 'update:email', 'update:age']) - 模板中绑定原生元素时,用
:value+@input或更现代的@change/@blur触发对应更新:<input :value="firstName"><br><input type="email" :value="email"><br><input type="number" :value="age" number>
修饰符怎么加?自定义逻辑轻松注入
v-model 修饰符本质是父组件传入的布尔 prop(如 v-model.trim → trim: true),子组件通过 defineModel 第二个参数接收并判断:
- 父组件:
- 子组件:
const model = defineModel({<br> modifiers: { trim: false, capitalize: false }<br>})<br>// 使用时:<br>const processed = model.value<br> .toString()<br> .trim() // 只有 trim: true 时才执行<br> .replace(/^\w/, c => c.toUpperCase()) // 只有 capitalize: true 时才执行
常见坑与关键细节
这些点不注意容易导致数据不同步或控制台报错:
-
避免在 defineModel 中设 default:如果写了
defineModel('xxx', { default: 'abc' }),而父组件没传该 v-model,子组件会用默认值,但父组件变量仍是 undefined,造成单向失联。 -
修饰符命名必须小写且无连字符:
v-model.my-modifier不合法,应写成v-model.myModifier,并在 modifiers 配置中用驼峰键名匹配。 - 多个 v-model 之间互不影响:每个绑定独立维护自己的 prop 和事件流,适合封装用户资料、表单分组、配置面板等复杂场景。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










