(day10-1)
事件名、自定义组件的v-model、将原生事件绑定到组件、.sync修饰符。
一、事件名
事件名,v-on:后面接的就是事件名。我们知道如何定义自定义事件以后,很多事件名就是我们自己命名。在这种请况下,我们在JavaScript 中定义的事件名,和我们在HTML中通过 v-on: 事件监听器监听的事件名称要 完全匹配。所以利用camelCase或者PascalCase的书写方式来命名事件名是不行的——因为在HTML中将事件名给转换为全小写。
所以,推荐始终使用kebab-case的事件名。
二、自定义组件的v-model
在前面我们已经知道了 v-model 可以用在普通的表单输入控件 以及 组件,这两种情况要区分一下。
在普通的输入控件中使用 v-model ,从现在学到的程度,就是它其实等价于两步操作——一是绑定输入控件的value值,二是将input事件的事件处理程序设置为 “searchText=$event.target.value”(这里的searchText是我们 v-model =“”中定义的变量名)。
在组件中使用 v-model ,又会有一些变化,也等价于两步操作——一是绑定模板中定义控件的value值,二是将input事件的事件处理程序设置为“searchText=$event”。有一些不一样的地方就是第二步,那么要消除这些差异,就需要在JavaScript中定义组件模板的时候,使用自定义事件的方式,让组件模板中的表单输入控件的 input事件 的第二个参数等同于 $event.target.value ,这样就可以将这个参数值通过 $event 传递给在HTML 中定义的自定义组件。
当在这个组件中包含的表单输入控件 是单选框、复选框等类型的输入控件时可能会将 value attribute用于不同的目的。这种情况,我们需要 v-model 要跟踪的值不是 value,而是‘checked’,那么我们就要解决这个冲突,通过 Vue API提供的 model选项 来避免这个冲突:
Vue.component('base-checkbox',{
model:{
prop:'checked',
event:'change'
},
props:{
checked:Boolean
},
template:`<input type="checkbox" v-bind:checked="checked"
v-on:change="$emit('change',$event.target.value)">`
});
现在就可以在HTML中的这个自定义组将中直接使用 v-model:
<base-checkbox v-model="lovingVue"></base-checkbox>
这里的lovingVue 的值将会传入这个名为 checked 的prop。同时当
<base-checkbox>
触发一个change
事件并附带一个新的值的时候,这个lovingVue
的 property 将会被更新。注意:你仍然需要在组件的
props
选项里声明checked
这个 prop。就像前面“组件基础”中讲到的 在组件中使用v-model 示例一样,需要在prop中定义value prop。
三、将原生事件绑定到组件
# 普通的做法: .native 修饰符
<base-input v-on:focus.native="onFous"></base-input>
# 特殊做法: $listeners 属性
当在某些特殊情况下——在你尝试监听一个类似于 <input> 的非常特定的元素时,比如上述 <base-input>
组件可能做了如下重构,所以根元素实际上是一个 <label>
元素:
<label>
{{label}}
<input v-bind="$attrs" v-bind:value="value"
v-on:input="$emit('input',$event.target.value)"/>
</label>
这时,父级的 .native
监听器将静默失败。它不会产生任何报错,但是 onFocus
处理函数不会如你预期地被调用。
为了解决这个问题,使用 $listenters属性:
Vue.component('base-input',{
inheritAttrs:false,
props:['label','value'],
computed:{
inputListeners:function(){
var vm = this;
//'Object.assign'将所有的对象合并为一个新对象
return Object.assign({},
//我们从父级添加所有的监听器
this.$Listeners,
//然后我们添加自定义监听器
//或覆写一些监听器行为
{
//这里确保组件配合'v-model'的工作
input:function(event){
vm.$enit('input',event.target.value);
}
}
);
}
},
template:`<label>
<input v-bind="$attrs" v-bind:value="value" v-on="inputListeners"/>
</label>`
});
现在 <base-input>
组件是一个完全透明的包裹器了,也就是说它可以完全像一个普通的 <input>
元素一样使用了:所有跟它相同的 attribute 和监听器都可以工作,不必再使用 .native
监听器。
$listeners 属性,就是一个对象,里面包含了作用在这个组件上的所有监听器。例如:
{ focus:function(event){/*...*/} input:function(event){/*...*/} }
四、.sync修饰符
在有些情况下,我们需要对一个 prop 进行“双向绑定”。不幸的是,真正的双向绑定会带来维护上的问题,因为子组件可以变更父组件,且在父组件和子组件的两侧都没有明显的变更来源。(需要自己下去再了解一下双向绑定的具体意思以及实现)
由于上面所说的问题,推荐使用 update:myPropName 的模式触发事件来代替。
举个例子,在一个包含
title
prop 的假设的组件中,我们可以用以下方法表达对其赋新值的意图:this.$emit('update:title',newTitle);
然后父组件可以监听那个事件并根据需要更新一个本地的数据 property。例如:
<text-document v-bind:title="doc.title" v-on:update:title="doc.title=$event"> </text-document>
那么这个就可以使用 .sync 修饰符来讲缩写上面的模板:
<text-document v-bind:title.sync="doc.title"></text-document>
# 当然,我们用一个对象同时设置多个 prop 的时候,也可以将这个
.sync
修饰符和v-bind
配合使用:<text-document v-bind.sync="doc"></text-document>
注意:
# 带有
.sync
修饰符的v-bind
不能和表达式一起使用 (例如v-bind:title.sync=”doc.title + ‘!’”
是无效的)。取而代之的是,你只能提供你想要绑定的 property 名,类似v-model
。#
v-bind.sync
用在一个字面量的对象上,例如v-bind.sync=”{ title: doc.title }”
,是无法正常工作的,因为在解析一个像这样的复杂表达式的时候,有很多边缘情况需要考虑。