Vue.js中怎么使用v-model绑定表单？-js教程-PHP中文网

Vue.js中怎么使用v-model绑定表单？

煙雲

发布： 2025-06-26 13:54:02

原创

174人浏览过

v-model 是 vue.js 中用于实现表单元素与数据属性双向绑定的指令。其核心作用是同步表单输入与 vue 实例的数据，支持多种输入类型如文本框、复选框、单选按钮和选择框，并提供 .lazy、.number 和 .trim 等修饰符以增强控制能力。1. 对于文本输入，直接使用 v-model 绑定字符串；2. 复选框可绑定布尔值或数组；3. 单选按钮绑定字符串；4. 选择框绑定选中项的 value 值。在自定义组件中使用 v-model 需要接收 value prop 并触发 input 事件，也可通过 model 选项自定义 prop 和 event 名称。复杂表单场景可通过计算属性、自定义事件或 vuex 管理状态来优化。为避免性能问题，应减少不必要的绑定、使用防抖节流、利用计算属性缓存以及避免在大型列表中频繁使用 v-model。

Vue.js中怎么使用v-model绑定表单？

在Vue.js中，v-model 指令是实现双向数据绑定的利器，尤其在处理表单元素时，它能极大地简化代码，提高开发效率。简单来说，v-model 让你表单元素的值和 Vue 实例中的数据属性保持同步更新，修改一个，另一个也会跟着变。

解决方案

v-model 的使用非常直观，它主要应用于、、<select> 等表单元素。</select>

立即学习“前端免费学习笔记（深入）”；

基础用法：

对于元素，v-model 会根据 type 属性自动选择合适的绑定方式。例如，对于文本输入框：
```
<input type="text" v-model="message">
<p>你输入的是：{{ message }}</p>
```
登录后复制
在 Vue 实例中：
```
new Vue({
  el: '#app',
  data: {
    message: ''
  }
})
```
登录后复制
这段代码创建了一个文本输入框，并将输入框的值绑定到 Vue 实例的 message 数据属性。每当输入框中的值发生变化，message 的值也会同步更新，反之亦然。

处理不同类型的输入框：

文本框 (type="text") 和文本域 (): 如上例所示，直接绑定即可。

复选框 (type="checkbox"): v-model 绑定到布尔值。如果绑定到单个复选框，则复选框的选中状态会影响布尔值；如果绑定到多个复选框，则 v-model 的值会是一个数组，包含所有选中的复选框的值。

<input type="checkbox" id="checkbox" v-model="checked">
<label for="checkbox">{{ checked }}</label>

<input type="checkbox" id="jack" value="Jack" v-model="checkedNames">
<label for="jack">Jack</label>
<input type="checkbox" id="john" value="John" v-model="checkedNames">
<label for="john">John</label>
<input type="checkbox" id="mike" value="Mike" v-model="checkedNames">
<label for="mike">Mike</label>
<br>
<span>Checked names: {{ checkedNames }}</span>

登录后复制

new Vue({
  el: '#app',
  data: {
    checked: false,
    checkedNames: []
  }
})

登录后复制

单选按钮 (type="radio"): v-model 绑定到字符串。选中的单选按钮的 value 值会赋给 v-model 绑定的数据属性。

<input type="radio" id="one" value="One" v-model="picked">
<label for="one">One</label>
<input type="radio" id="two" value="Two" v-model="picked">
<label for="two">Two</label>
<br>
<span>Picked: {{ picked }}</span>

登录后复制

new Vue({
  el: '#app',
  data: {
    picked: ''
  }
})

登录后复制

选择框 (: v-model 绑定到选中的

<select v-model="selected">
  <option disabled value="">请选择</option>
  <option>A</option>
  <option>B</option>
  <option>C</option>
</select>
<span>Selected: {{ selected }}</span>

登录后复制

new Vue({
  el: '#app',
  data: {
    selected: ''
  }
})

登录后复制

v-model 的修饰符：

v-model 提供了几个修饰符，用于更精细地控制数据绑定行为：
- .lazy: 默认情况下，v-model 在 input 事件后同步数据。使用 .lazy 修饰符后，数据将在 change 事件后同步，即失去焦点或按下回车键时。
```
<input type="text" v-model.lazy="message">
```
  登录后复制
- .number: 自动将用户的输入值转换为 Number 类型。如果转换失败，则返回原始值。
```
<input type="text" v-model.number="age">
```
  登录后复制
- .trim: 自动去除用户输入的首尾空白字符。
```
<input type="text" v-model.trim="name">
```
  登录后复制

如何处理复杂的表单数据绑定？

当表单变得复杂时，例如包含嵌套的对象或数组，直接使用 v-model 可能会显得不够灵活。这时，可以考虑以下方法：

计算属性 (Computed Properties): 使用计算属性来格式化或转换表单数据。例如，将多个输入框的值合并成一个对象。
自定义事件 (Custom Events): 对于更复杂的组件，可以使用自定义事件来通知父组件数据变化，然后在父组件中更新数据。这可以更好地控制数据的流动。
Vuex (Vuex): 如果应用规模较大，并且需要在多个组件之间共享表单数据，可以考虑使用 Vuex 状态管理库。Vuex 可以集中管理应用的状态，并提供统一的数据访问和修改方式。

v-model在自定义组件中如何使用？

在自定义组件中使用 v-model 需要一些额外的配置。默认情况下，v-model 会尝试修改组件的 value prop 并触发 input 事件。因此，你的组件需要：

接受 value prop： 组件需要声明一个名为 value 的 prop。
触发 input 事件： 当组件内部的值发生变化时，需要触发一个名为 input 的事件，并将新的值作为参数传递出去。

示例：

// MyInput.vue
<template>
  <input
    :value="value"
    @input="$emit('input', $event.target.value)"
  >
</template>

<script>
export default {
  props: ['value']
}
</script>

登录后复制

在父组件中使用：

<template>
  <my-input v-model="message"></my-input>
  <p>Message: {{ message }}</p>
</template>

<script>
import MyInput from './MyInput.vue'

export default {
  components: {
    MyInput
  },
  data() {
    return {
      message: ''
    }
  }
}
</script>

登录后复制

Vue 2.3.0+ 允许自定义 v-model 的 prop 和 event 名称：

// MyInput.vue
<template>
  <input
    :value="modelValue"
    @input="$emit('update:modelValue', $event.target.value)"
  >
</template>

<script>
export default {
  props: {
    modelValue: String
  },
  emits: ['update:modelValue']
}
</script>

登录后复制

在父组件中使用：

<template>
  <my-input v-model="message"></my-input>
  <p>Message: {{ message }}</p>
</template>

<script>
import MyInput from './MyInput.vue'

export default {
  components: {
    MyInput
  },
  data() {
    return {
      message: ''
    }
  }
}
</script>

登录后复制

如何避免v-model引起的性能问题？

虽然 v-model 很方便，但在大型应用中，频繁的数据同步可能会导致性能问题。以下是一些建议：

减少不必要的绑定： 只在需要双向数据绑定时才使用 v-model。对于只需要单向数据绑定的情况，使用 :value 和 @input 事件手动更新数据。

使用 debounce 或 throttle： 对于需要频繁更新的数据，可以使用 debounce 或 throttle 函数来限制更新频率。例如，可以使用 Lodash 库中的 debounce 函数。

<input type="text" :value="message" @input="debouncedUpdate">

登录后复制

import { debounce } from 'lodash';

new Vue({
  el: '#app',
  data: {
    message: ''
  },
  mounted() {
    this.debouncedUpdate = debounce(this.updateMessage, 500);
  },
  methods: {
    updateMessage(event) {
      this.message = event.target.value;
    }
  }
})

登录后复制