7

Overview

开门见山,首先从上帝视角看一下 v-model 发生了什么改变:

  • 重大变更:在自定义组件上使用 v-model 时,属性以及事件的默认名称变了:

    • 属性:value => modelValue
    • 事件:input => update:modelValue
  • 重大变更v-bind.sync 修饰符和组件的 model 选项被干掉了,取而代之的是 v-model 参数
  • 新特性: 支持同一组件同时设置多个 v-model
  • 新特性:支持开发者自定义 v-model 修饰符

Introduction

遥想当年,Vue 2.0 发布的时候,v-model 只能绑定在组件的 value 属性上。开发者可就着急了:“淦,我自己的组件想用一个别的属性都不行吗”,其实也是支持的:v-bind.sync 了解一下。

在 Vue 2.2 的版本,组件支持了自定义的 model ,开发者可以通过这个设置和 v-model 关联的属性和事件。用了几次还是挺香的,但还有一个没法 hack 的短板:单个组件无法绑定多个 v-model

在即将到来的 Vue 3 中,为了减少给开发者带来的迷惑,官方团队对双向绑定的 API 重新做了“标准化”处理,同时也让 v-model 的使用更加灵活。

2.x 是这么玩的

在 Vue 2.x 版本中,在组件上使用 v-model 相当于传递了 value 属性并触发了 input 事件:

<KyrieInput v-model="name" />
<!-- 不同的写法,相同的本质 -->
<KyrieInput :value="name" @input="name = $event" />

如果想要改变 v-model 绑定的属性或者事件,需要在子组件内添加一个 model

// KyrieInput.vue
export default {
    model: {
        prop: 'title',
        event: 'change',
    },
}

经过上面的改造,现在 KyrieInput 这个组件 v-model 的本质变成了下面这样:

<KyrieInput :title="name" @change="name = $event" />

使用 v-bind.sync 实现组件属性的双向绑定

在某些场景下,我们需要实现对组件属性的双向绑定,比如:实现一个弹窗组件,用一个 visible 属性控制弹窗的出现和隐藏,可以在组件内部和外部关闭这个弹窗。官方团队推荐用 update:propName 的方式去解决这个问题。比如上面 KyrieInput 的例子,我们可以用下面这句话在组件内部改变 title 的值:

this.$emit('update:title', '关注我的你很酷');

然后在父组件监听这个事件:

<KyrieInput :title="name" @update:title="name = $event" />

方便起见,.sync 修饰符应运而生:

<KyrieInput :title.sync="name" />

3.x 应该这么玩儿

在 3.x 版本中,在自定义组件上使用 v-model 相当于传递了一个 modelValue 属性以及触发一个 update:modelValue 事件:

<KyrieInput v-model="name" />
<!-- 这两行其实是一样的 -->
<KyrieInput :modelValue="name" @update:modelValue="name = $event" />

v-model 参数

如果要改变绑定的属性名,只需要给 v-model 传递一个参数就好了:

<KyrieInput v-model:title="name" />
<!-- 等同于 -->
<KyrieInput :title="name" @update:title="name = $event" />

秒啊。

不仅如此,这个写法还彻底代替了 .sync 修饰符,并且支持统一组件绑定多个 v-model

<KyrieInput v-model:title="name" v-model:content="info" />
<!-- 相当于 -->
<KyrieInput
    :title="name"
    @update:title="name = $event"
    :content="info"
    @update:content="info = $event"
/>
想要了解更多信息,请访问官方:https://v3.vuejs.org/guide/mi...(目前还没有中文版)

文章首发于我的卫星攻肿号,请点击:这里


劉凯里
841 声望1.6k 粉丝

我可能是一个假前端