v-model 使用

v-model 是一个用于实现表单元素和组件双向数据绑定的指令。

核心作用是将表单输入的值与 Vue 实例的数据属性进行动态绑定,当用户修改输入时,数据会自动更新,反之亦然。


一、基本用法

v-model 常用于表单元素(如 <input><textarea><select>),直接绑定一个数据属性:

html 复制代码
<template>
  <input v-model="message" placeholder="输入内容">
  <p>输入的内容是:{{ message }}</p>
</template>

<script>
export default {
  data() {
    return {
      message: ""
    };
  }
};
</script>

二、v-model 的原理

v-model 是语法糖,底层基于 value 属性 + input 事件 实现双向绑定。例如,上述代码等价于:

html 复制代码
<input 
  :value="message" 
  @input="message = $event.target.value"
>

三、不同类型表单元素的处理

v-model 会根据不同的表单元素自动适配对应的属性和事件:

元素类型 绑定的属性 触发的事件
<input type="text"> value input
<textarea> value input
<input type="checkbox"> checked change
<input type="radio"> checked change
<select> value change

四、修饰符(Modifiers)

v-model 支持修饰符,用于处理输入值的特定需求:

  1. .lazy

    input 事件改为 change 事件(输入完成后更新数据):

    html 复制代码
    <input v-model.lazy="message">
  2. .number

    自动将输入值转为数值类型:

    html 复制代码
    <input v-model.number="age" type="number">
  3. .trim

    自动去除输入值的首尾空格:

    html 复制代码
    <input v-model.trim="username">
  4. 自定义修饰符

    子组件通过 this.$options.model.modifiers 访问修饰符,并根据修饰符对输入值进行加工处理。


五、在自定义组件中使用 v-model

在 Vue 2 中,自定义组件可以通过 model 选项定义 v-model 的绑定行为:

  1. 父组件

    html 复制代码
    <CustomInput v-model="message" />
  2. 子组件

    html 复制代码
    <template>
      <input 
        :value="value" 
        @input="$emit('input', $event.target.value)"
      >
    </template>
    
    <script>
    export default {
      model: {
        prop: "value",   // 默认是 'value'
        event: "input"   // 默认是 'input'
      },
      props: ["value"]
    };
    </script>

六、与 .sync 修饰符的区别

  • v-model :用于单个数据的双向绑定(默认绑定 valueinput)。
  • .sync 修饰符 :用于多个属性的"双向绑定"(通过 update:propName 事件)。
html 复制代码
<!-- 父组件 -->
<ChildComponent :title.sync="pageTitle" />

<!-- 子组件触发更新 -->
this.$emit('update:title', newTitle);

七、常见问题

  1. 为什么输入类型为 number 时,绑定的值仍是字符串?

    使用 .number 修饰符或手动转换类型:parseInt(value)

  2. 如何在一个组件中绑定多个 v-model

    Vue 2 不支持多个 v-model,但可以通过 .sync 修饰符实现多属性双向绑定。


总结

  • v-modelvalue + input 事件的语法糖。
  • 支持 .lazy.number.trim 修饰符。
  • 自定义组件通过 model 选项配置 propevent
  • 在 Vue 2 中,一个组件只能有一个 v-model,多数据流用 .sync

掌握 v-model 的使用和原理,能更高效地处理表单和组件间的数据交互!

相关推荐
程序视点1 小时前
Escrcpy 3.0投屏控制软件使用教程:无线/有线连接+虚拟显示功能详解
前端·后端
silent_missile1 小时前
element-plus穿梭框transfer的调整
前端·javascript·vue.js
专注VB编程开发20年1 小时前
OpenXml、NPOI、EPPlus、Spire.Office组件对EXCEL ole对象附件的支持
前端·.net·excel·spire.office·npoi·openxml·spire.excel
古蓬莱掌管玉米的神1 小时前
coze娱乐ai换脸
前端
GIS之路1 小时前
GeoTools 开发合集(全)
前端
咖啡の猫2 小时前
Shell脚本-嵌套循环应用案例
前端·chrome
一点一木2 小时前
使用现代 <img> 元素实现完美图片效果(2025 深度实战版)
前端·css·html
萌萌哒草头将军2 小时前
🚀🚀🚀 告别复制粘贴,这个高效的 Vite 插件让我摸鱼🐟时间更充足了!
前端·vite·trae
布列瑟农的星空2 小时前
大话设计模式——关注点分离原则下的事件处理
前端·后端·架构
yvvvy3 小时前
前端必懂的 Cache 缓存机制详解
前端