Vue 3 到底有什么不同：v-model 升级了

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"
/>