Vue的v-model指令有什么用？如何自定义表单组件？-Vue.js-PHP中文网

Vue的v-model指令有什么用？如何自定义表单组件？

尼克

发布： 2025-06-27 08:41:01

原创

829人浏览过

v-model 是 vue 中用于表单元素和组件间建立双向数据绑定的指令，能实现输入内容与数据自动同步。其基本用法是绑定 input 或 textarea 的值，如 <input v-model="message">，使 message 与输入框内容保持一致；在自定义组件中使用时，需通过 model 选项声明 prop 和 event，并用 $emit('input') 更新父组件数据；与 .sync 修饰符不同，v-model 只绑定一个值，而 .sync 支持多个属性的双向绑定；开发自定义表单组件时应支持 v-model、传递原生属性、处理事件透传，以提升组件易用性和兼容性。掌握 v-model 能显著提高表单类组件开发效率和规范性。

Vue的v-model指令有什么用？如何自定义表单组件？

v-model 在 Vue 中是一个非常实用的指令，它主要用来在表单元素和组件之间建立双向数据绑定。简单来说，就是当你在输入框中输入内容时，对应的数据会自动更新；反过来，如果数据发生变化，输入框中的值也会同步变化。

这在开发表单功能时特别方便，比如你有一个输入框，想让它的内容和某个变量保持一致，用 v-model 就可以轻松实现。

一、v-model 的基本用法

最常见的使用场景是直接作用在 <input> 或 <textarea> 上：

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

<input v-model="message">
<p>{{ message }}</p>

登录后复制

上面这段代码的意思是：输入框的内容和 message 这个变量始终保持一致。用户输入的时候，message 自动更新；如果你在 JS 中修改了 message，输入框的内容也会跟着变。

除了文本输入，v-model 也适用于复选框、单选按钮等表单控件，用法类似，只是绑定的值类型会有所不同。

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

Vue 的组件默认不支持 v-model，但我们可以手动模拟它的行为。

一个标准的做法是：父组件通过 v-model 绑定一个值到子组件，子组件通过 model 选项声明这个绑定，并通过 $emit('input') 来通知父组件更新数据。

举个例子，我们来写一个简单的自定义输入组件：

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

<script>
export default {
  model: {
    prop: 'value',
    event: 'input'
  },
  props: ['value']
}
</script>

登录后复制

然后在父组件里这样使用：

表单大师AI

一款基于自然语言处理技术的智能在线表单创建工具，可以帮助用户快速、高效地生成各类专业表单。

查看详情

<MyInput v-model="message" />

登录后复制

这样就实现了和原生 input 一样的双向绑定效果。

三、v-model 和 .sync 修饰符的区别

有些同学可能会混淆 v-model 和 .sync 修饰符，这里简单说一下它们的不同点：

v-model 是一种语法糖，只能绑定一个值（通常是 value + input 事件）。
.sync 是用来处理多个属性的双向绑定，适合需要同步多个 prop 的情况。

例如：

<MyComponent :title.sync="pageTitle" />

登录后复制

这时候子组件要触发 update:title 事件才能更新父组件的数据。

所以，如果你只需要同步一个值，优先用 v-model；如果是多个值，可以用 .sync 或者直接用 emit 手动控制。

四、自定义表单组件的小技巧

有时候我们会封装一些复杂的表单组件，比如带下拉选择的时间输入、带格式校验的输入框等等。这种情况下，为了让组件能更好地融入 Vue 的生态，建议做到以下几点：

支持 v-model：让使用者能像操作普通 input 一样使用你的组件；
传递原生属性：比如 placeholder、disabled、readonly 等，可以通过 v-bind="$attrs" 直接传给内部的 <input>；
处理 focus/blur 等事件：如果有必要，记得把这些事件也透传出去，让用户能监听到。