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...(目前还没有中文版)文章首发于我的卫星攻肿号,请点击:这里
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。