开门见山 ![](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9wbjQ1aHlYYnhEcjJOSDhSUnRuNEdNanZlcVJqaWF0SUlBZG56T05saWNuUjI0aWJ2cklDb3VqY0x2UUdBVW9pYzFFWnJUeDBFVzlCeTZhd0dmYklQQjJGS0EvNjQw?x-oss-process=image/format,png)
首先从上帝视角看一下 v-model
发生了什么改变:
重大变更:在自定义组件上使用 v-model 时,属性以及事件的默认名称变了:
属性:
value
=>modelValue
事件:
input
=>update:modelValue
重大变更:
v-bind
的.sync
修饰符和组件的model
选项被干掉了,取而代之的是v-model
参数新特性:支持同一组件同时设置多个
v-model
新特性:支持开发者自定义
v-model
修饰符
v-model
历史回顾 ![](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9wbjQ1aHlYYnhEcjJOSDhSUnRuNEdNanZlcVJqaWF0SUlOdGlia1lKaWJTT2JIbU1aOTRQN3RrVDdCN0dCeGRHTlNZU21OelpYRWlhb0ZpYXZXNktSVjg3cDBBLzY0MA?x-oss-process=image/format,png)
遥想当年,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 是这么玩的 ![](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9wbjQ1aHlYYnhEcjJOSDhSUnRuNEdNanZlcVJqaWF0SUllNzltVFVaWTU1U2pBZHUxV2ljMjhCNVBQYTRwY0MxUWZ2dEIzYktxYzR4RHVJZGZZUHVCaWM4dy82NDA?x-oss-process=image/format,png)
在 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
实现组件属性的双向绑定 ![](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9wbjQ1aHlYYnhEcjJOSDhSUnRuNEdNanZlcVJqaWF0SUk5RjZPMUpsSlFjU3E2Skw3M0FWc0phOTFFSFRFZjdwVERKQktUNDMxMDVWMlpCNVQ5blExbXcvNjQw?x-oss-process=image/format,png)
在某些场景下,我们需要实现对组件属性的双向绑定,比如:实现一个弹窗组件,用一个 visible
属性控制弹窗的出现和隐藏,可以在组件内部和外部关闭这个弹窗。官方团队推荐用 update:propName
的方式去解决这个问题。比如上面 KyrieInput 的例子,我们可以用下面这句话在组件内部改变 title
的值:
this.$emit('update:title', '关注我的你很酷');
然后在父组件监听这个事件:
<KyrieInput :title="name" @update:title="name = $event" />
方便起见,.sync
修饰符应运而生:
<KyrieInput :title.sync="name" />
3.x 应该这么玩儿 ![](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9wbjQ1aHlYYnhEcjJOSDhSUnRuNEdNanZlcVJqaWF0SUltSHNKaGdHTkhFd1h1cTRHcUh5SW5ZcDhWRW51aWNSbEVyRnE5aWMwQzU5ZFJwZWJjTVpHb1JUZy82NDA?x-oss-process=image/format,png)
在 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"
/>
总的来说,v-model 这次的升级还是很酷的,很大程度上提升了代码的可读性。如果你想获得更多关于 Vue 3 中 v-model 的信息,去这里看看吧:https://v3.vuejs.org/guide/migration/v-model.html#overview(目前还没有中文版)。