v-model是Vue中实现表单元素与数据双向绑定的指令,自动同步输入内容与变量值;支持文本框、多行文本、单选框、复选框等不同表单类型,提供.lazy、.number、.trim等修饰符优化行为,并可通过modelValue prop和update:modelValue事件在自定义组件中使用。

v-model 是 Vue 里最常用也最直观的双向绑定方式,一句话说清:它让表单元素(如输入框、下拉框、复选框)和数据变量自动保持同步——你改输入内容,变量立刻变;你改变量值,输入框也立刻更新。
基础用法:三步搞定文本框绑定
不需要额外监听事件或手动赋值,只要两处写法:
- 在 Vue 实例中定义一个响应式数据,比如 message: ''
- 在
标签上写 v-model="message" - 在模板里用
{{ message }}显示当前值,就能看到实时联动
不同表单元素的写法差异
不是所有表单都用同一套逻辑,关键看数据类型:
从零开始编排 SpringBoot+Vue 全栈项目工作流,适用于新建全栈项目或完整脚手架请求,触发后依次调用 product‑spec‑builder(需求调研)等模块。
-
文本框 / 密码框:
,默认绑定字符串 -
多行文本:
,注意不用在标签内写默认内容,否则会被覆盖 -
单选框:多个
共享同一个v-model,绑定值等于其value属性 -
复选框(单个):绑定布尔值,
-
复选框(多个):绑定数组,每个选项的
value被选中时自动加入/移出该数组
修饰符让绑定更智能
加个点号就能优化行为,不写也能用,但写了更省心:
-
.lazy:把同步时机从
input改为change(比如失焦后才更新),适合搜索框防抖 -
.number:自动把输入内容转成数字,避免字符串拼接,
- .trim:自动去掉首尾空格,对用户名、邮箱等输入很实用
自定义组件也能用 v-model
想封装一个带校验的输入框?子组件要满足两个条件:
- 接收一个叫 modelValue 的 prop(Vue 3)或 value(Vue 2)
- 内部修改时,通过
$emit('update:modelValue', newValue)(Vue 3)或$emit('input', newValue)(Vue 2)通知父组件 - 父组件写法不变:
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!









