本文已经过原作者 ichael Thiessen 授权翻译。
Vue v-model是一个指令，它提供了input和form之间或两个组件之间的双向数据绑定。
这是Vue开发中的一个简单概念，但v-model的真正威力需要花些时间才能理解。
本文主要讲解v-model的不同用例，并学习如何在自己的项目中使用它。
v-model 是什么?
刚才讲过，``v-model`是一个我们可以在模板代码中使用的指令。指令是一个模板令牌，它告诉 Vue 我们想要如何处理 DOM。
在v-model的情况下，它告诉Vue我们想要在template 中的值和data属性中的值之间创建一个双向数据绑定。
使用v-model的一个常见用例是在设计表单相关的一些元素时。我们可以使用它使input元素能够修改Vue实例中的数据。
- <template>
- <div>
- <input
- type='text'
- v-model='value'
- />
- <p> Value: {{ value }} </p>
- </div>
- </template>
- <script>
- export default {
- data() {
- return {
- value: 'Hello World'
- }
- }
- }
- </script>
当我们在input中输入内容时，我们会看到我们的数据属性正在变化
v-model 和 v-bind 之间的区别?
v-bind指令通常会与v-model切换。两者的区别在于v-model提供了双向数据绑定。
在我们的例子中，这意味着如果我们的数据改变了，我们的input也会改变，如果我们的input改变了，我们的数据也会改变。
而 v-bind 只以一种方式绑定数据。
当我们想在自己的应用中创建一个清晰的单向数据流时，这是非常有用的。但是，在v-model和v-bind之间选择时必须小心。
v-model 的修饰符
Vue 提供了两个修饰符，允许我们更改v-model的功能。每一个都可以像这样加起来，甚至可以连接在一起。
- <input
- type='text'
- v-model.trim.lazy='value'
- />
.lazy
默认情况下，v-model在每个input事件上与Vue实例的状态(数据属性)同步。这包括获得/失去焦点等。
.lazy修改器修改了我们的v-model，所以它只在更改事件之后同步。这减少了v-model试图与Vue实例同步的次数，在某些情况下，还可以提高性能。
.number
通常，即使输入的是数字类型，input也会自动将输入的值变为字符串。确保将我们的值作为数字处理的一种方法是使用.number修饰符。
根据Vue文档，如果input发生变化，并且parseFloat()无法解析新值，那么将返回输入的最后一个有效值。
- <input
- type='number'
- v-model.number='value'
- />
.trim
与大多数编程语言中的trim方法类似，.trim修饰符在返回值之前删除开头或结尾的空白。
在自定义组件中使用 v-model
在Vue中，数据绑定有两个主要步骤：
从父节点传递数据
从子实例发出事件以更新父实例
在自定义组件上使用v-model可以让我们传递一个 prop，用一个指令来处理一个事件。
- <custom-text-input v-model="value" />
- <!-- IS THE SAME AS -->
- <custom-text-input
- :modelValue="value"
- @update:modelValue="value = $event"
- />
这到底是什么意思?
使用v-model传递的值的默认名称是modelValue。但是，我们也可以像这样传递一个自定义名称。
- <custom-text-input v-model:name="value" />
注意：当我们使用自定义模型名称时，发出的方法的名称将为update:name。
在自定义组件中使用 v-model
在自定义组件中使用 v-mode ，需要做两件事：
- 在 props 中接收 v-model 的值。
- 当对应的值变化时，发出一个更新事件
ok，首先来声明一下：
- export default {
- props: {
- modelValue: String,
- }
- }
接下来，将 modelValue 绑定到需要的元素，当值变化时，我们就通过update:modelValue 发出新值。
这样就可以实现双向绑定了。
v-model 的使用技巧
上面介绍了如果在自定义组件中使用 v-model，现在来看看一些v-model指令更高级的用法。
对一个组件多次使用v-model
v-model并不局限于每个组件只能使用一个。要多次使用v-model，我们只需要确保唯一命名，并在子组件中正确访问它。
为下面的组件添加第二个 v-model，这里先命名为 lastName:
- <template>
- <div>
- <custom-text-input
- v-model='value'
- v-model:lastName='lastName'
- />
- <p> Value: {{ value }} </p>
- <p> Last Name: {{ lastName }} </p>
- </div>
- </template>
- <script>
- import CustomTextInput from './CustomTextInput.vue'
- export default {
- components: {
- CustomTextInput,
- },
- data() {
- return {
- value: 'Matt',
- lastName: 'Maribojoc'
- }
- }
- }
- </script>
然后，我们内部的子组件:
- <template>
- <div>
- <label> First Name </label>
- <input
- type='text'
- :value='modelValue'
- placeholder='Input'
- @input='$emit("update:modelValue", $event.target.value)'
- />
- <label> Last Name </label>
- <input
- type='text'
- :value='lastName'
- placeholder='Input'
- @input='$emit("update:lastName", $event.target.value)'
- />
- </div>
- </template>
- <script>
- export default {
- props: {
- lastName: String,
- modelValue: String,
- }
- }
- </script>
运行后，可以看到两个 v-model 都可以正常工作：
自定义 v-model 的修饰符
Vue中内置了一些修饰符，但这些远远不够，所以有时我们需要自定义自己的修饰符。
假设我们要创建一个修饰符，以删除输入的文本中的所有空格。我们称之为no-whitespace ：
- <custom-text-input
- v-model.no-whitespace='value'
- v-model:lastName='lastName'
- />
在组件内，我们可以使用 props 来捕获修改器。自定义修饰符的名称是nameModifiers
- props: {
- lastName: String,
- modelValue: String,
- modelModifiers: {
- default: () => ({})
- }
- },
我们要做的第一件事是改变@input处理器来使用一个自定义方法。我们可以称它为emitValue，它接受正在编辑的属性和事件对象的名称。
- <label> First Name </label>
- <input
- type='text'
- :value='modelValue'
- placeholder='Input'
- @input='emitValue("modelValue", $event)'
- />
在emitValue方法中，在调用$emit之前，我们要检查修饰符。如果no-whitespace修饰符为true，则可以在将其发送给父对象之前修改该值。
- emitValue(propName, evt) {
- let val = evt.target.value
- if (this.modelModifiers['no-whitespace']) {
- val = val.replace(/\s/g, '')
- }
- this.$emit(`update:${propName}`, val)
- }
运行，完美：
总结
希望本文能教给大家一些有关Vue v-model的新知识。
在它的基本用例(如表单和input数据)中，v-model是一个非常简单的概念。然而，当我们创建自定义组件并处理更复杂的数据时，我们可以释放v-model的真正威力。
~完，我是刷碗智，我要去刷碗了，我们下期见!
作者：Michael Thiessen
译者：前端小智 来源：news
原文：https://learnvue.co/2021/01/everything-you-need-to-know-about-vue-v-model/
本文转载自微信公众号「大迁世界」，可以通过以下二维码关注。转载本文请联系大迁世界公众号。
