Vue不仅内置了各类指令,包括条件渲染、事件处理等,还能注册自定义指令。
一、条件渲染
条件渲染的指令包括v-if、v-else、v-else-if和v-show。
1)v-if
该指令的功能和条件语句中的if类似,可根据表达式的计算结果,判断是否渲染分支中的元素和它所包含的子元素。在下面的示例中,当把数据对象的exist属性设为true时,
两个元素就会被添加到页面的DOM中。
<div v-if="exist"> <p>strickp> div> <script> var vm = new Vue({ data: { exist: true } }); script>
当需要通过v-if指令渲染多个元素,并且不必指定包裹元素时,就得使用Vue提供的元素了,如下代码所示。其功能类似于React的Fragments,也可生成一个不可见的包裹元素,并且在最终的DOM中,不会包含元素。
<template v-if="exist"> <p>strickp> <p>freedomp> template>
2)v-else
该指令的功能和条件语句中的else类似,需要与v-if配合使用,并且要紧跟在v-if或v-else-if之后(如下所示),否则该指令将失效。
<p v-if="exist">strickp> <p v-else>freedomp>
3)v-else-if
该指令与v-else类似,也需要紧跟在v-if或v-else-if之后,但它能自定义条件表达式,如下所示。
<p v-if="digit==1">strickp> <p v-else-if="digit==2">justifyp> <p v-else>freedomp>
4)v-show
该指令能根据表达式的计算结果显示或隐藏当前元素,如果得到的结果是一个假值,那么会为元素添加内联样式“display: none;”,如下所示。
<p v-show="false">strickp>
v-if会在切换过程中创建或销毁可能包含的数据绑定和子元素,并且只有在条件为真时,才会渲染该分支中的元素。而v-show无论条件的真假都会渲染元素,很适合频繁切换,并且要注意,v-show既不能作用于元素,也无法与v-else配合。由前面的分析可知,v-if有更高的切换开销而v-show有更高的初始渲染开销。
二、列表渲染
v-for是一个用于列表渲染的指令,它能接收数组、对象和整数,并且支持元素。
1)数组
当基于数组来渲染一个列表时,v-for指令可迭代数组的元素和其索引。下面是一个示例,在第一组
<ul id="container"> <li v-for="item in array"> {{item}} li> <li v-for="(item, index) in array"> {{index}} - {{item}} li> ul> <script> var vm = new Vue({ el: "#container", data: { array: ["strick", "freedom"] } }); script>
v-for指令中的in还可以替换成of,从而更接近ES6迭代器的语法,如下所示。
<li v-for="item of array"> {{item}} li>
2)对象
当基于对象来渲染一个列表时,v-for指令可迭代对象的属性(即键值对)和其索引。在下面的示例中,为v-for指令传递了三个参数,其中属性值在前,属性名在后。
<li v-for="(value, key, index) in obj"> {{index}} - {{key}} - {{value}} li>
3)整数
v-for指令接收的整数,可用于循环次数,如下所示,其中digit从1开始计数。
<li v-for="digit in 3"> {{digit}} li>
4)key特性
Vue为元素提供了一个能标识其身份的key特性,利用该特性可让diff算法快速找到变化的节点,并且高效的将其插入到新位置,而不用渲染无变化的元素。可以像下面这样为每个
<ul id="container"> <li v-for="item in peoples" v-bind:key="item.id"> {{item}} li> ul> <script> var vm = new Vue({ el: "#container", data: { peoples: [ { id: 1, name: "strick" }, { id: 2, name: "freedom" } ] } }); script>
注意,兄弟元素之间的key特性要保持唯一性,即相同父元素的子元素,其key特性要独一无二。下面这样会让key重复,从而造成渲染错误。
<ul id="container"> <li v-for="item in peoples" v-bind:key="item.id"> {{item}} li> <li v-for="item in peoples" v-bind:key="item.id"> {{item}} li> ul>
为了渲染高效,Vue通常会复用已有元素而不是重新渲染,但如果要强制替换元素,那么可以使用key特性。例如有两个文本框,如下代码所示,由于两个文本框都声明了key特性,因此每次通过v-if指令进行切换时,其内容都会被清空。
<input placeholder="enter name" key="name" v-if="display"/> <input placeholder="enter age" key="age" v-else/>
5)数组更新检测
Vue包装了多个会修改原始数组的变异方法(Mutation Method),例如push()、shift()、splice()等,每当调用这些方法时,都会触发视图更新。在下面的示例中,vm是一个Vue实例,peoples是一个数组,一旦调用push()方法,就会将新增的对象渲染到页面中。
vm.peoples.push({id:3, name:"justify"});
对于那些filter()、concat()、slice()等非变异方法,可通过替换数组来触发视图的更新,如下所示。
vm.peoples = vm.peoples.slice(0, 1);
三、事件处理
Vue提供了用于注册事件的v-on指令,它的参数是事件类型,接收的表达式既可以是方法名,也可以是内联语句,并且能与多个修饰符配合使用。
1)v-on
当接收一个方法名时,默认会将事件对象作为第一个参数传递给事件处理程序,例如下面dot()方法中的e参数。
<button v-on:click="dot">点击button> <script> var vm = new Vue({ data: { name: "strick" }, methods: { dot: function(e) { console.log(e, this.name); } } }); script>
当接收一条内联语句时,可通过一个特殊的$event变量传递事件对象,并且可声明在形参列表的任意位置,如下所示。
<button v-on:click="dot(28, $event, 'university')">点击button> <script> var vm = new Vue({ data: { name: "strick" }, methods: { dot: function(age, e, school) { console.log(e, this.name, age, school); } } }); script>
v-on还有一种简写形式,用“@”符号替代“v-on:”,如下代码所示,后文的示例都会使用该形式。
<button @click="dot">点击button>
如果要在同一个事件类型中执行多个事件处理程序,那么可以像下面这样用逗号把两条内联语句隔开。
<button @click="dot1(),dot2()">点击button>
2)修饰符
v-on支持多种类型的修饰符(包括事件、按键、鼠标等),在事件细节的处理方面,提供了更多的选择,例如可用的事件修饰符如表1所列。
表1 事件修饰符
修饰符 | 作用 |
.stop | 调用事件对象的stopPropagation()方法 |
.prevent | 调用事件对象的preventDefault()方法 |
.capture | 采用捕获的事件传播形式 |
.self | 只有当事件是由注册的元素触发的,即event.target等于绑定该事件的元素,才执行回调 |
.once | 事件只会触发一次 |
.passive | 永不调用preventDefault()方法,注意,不能与.prevent一起使用 |
当串联多个修饰符时,会按顺序影响事件的处理,即不同的顺序会产生不同的效果。下面用一个示例来演示不同排列所造成的差异,其中print()方法用于打印接收的参数,
<div @click="print('div')"> <section @click.stop.self="print('section')"> <button @click="print('button')">点击button> section> div>
当将@click.stop.self作用于
除了事件修饰符之外,Vue还提供了按键修饰符,只有当按下特定的键时,才会触发监听的键盘事件。在下面的示例中,.arrow-down修饰符表示导航键中的向下键(ArrowDown)。注意,只要是KeyboardEvent.key提供的有效键名,都能转换成连字符分隔(kebab-case)的修饰符形式。
<input @keyup.arrow-down="enter" />
不仅如此,通过事件对象的keyCode属性得到的建码也能作为修饰符使用,例如ArrowDown的建码是40,可以像下面这样声明。
<input @keyup.40="enter" />
由于键码不便记忆,因此Vue提供了常用键码的别名,例如.enter、.tab、.space、.down等。对于那些不常用的建码,可通过Vue.config.keyCodes自定义,例如为F12键创建别名,如下所示。
Vue.config.keyCodes.f12 = 123;
有一点要注意,keyCode已从Web标准中移除,在未来可能也会被最新的浏览器废弃,因此要慎用该类修饰符。
Vue 2.1.0新增了四个特殊的系统修饰键:.ctrl、.alt、.shift和.meta,其中.meta会随着操作系统的不同而对应不同的键,例如在Mac系统中对应command键,而在Windows系统中对应Windows图标键。与按键修饰符不同,在与keyup事件配合时,系统修饰键必须处于按下状态,否则无法触发事件。以下面的文本框为例,如果要执行回调函数enter(),不仅要按一下ArrowDown键,还得同时按住Ctrl键。
<input @keyup.arrow-down.ctrl="enter" />
Vue 2.5.0新增了一个特殊的.exact修饰符,用于控制系统修饰键的组合。在下面的示例中,第一个文本框中的事件,可通过单独按下Ctrl键或与其它修饰键组合触发;第二个文本框添加了.exact修饰符,只有按下Ctrl键才会触发事件,无法与其它修饰键组合。
<input @keyup.ctrl="enter" /> <input @keyup.ctrl.exact="enter" />
Vue 2.2.0新增了三个用于鼠标事件的修饰符:.left、.right和.middle,分别对应三种鼠标按键状态:左键,右键和中键。
四、自定义指令
由于内置指令无法满足所有场景,因此Vue允许用户注册自定义的指令,以便封装特殊的DOM行为,提升代码复用率。
1)注册
可在实例的directives选项中注册局部指令,例如为文本框自动输入一段字符,如下代码所示。其中autoEnter是指令名称,它的值是一个指令的定义对象,注意,在元素中使用该自定义指令时,不能采用驼峰的方式。
<input v-auto-enter/> <script> var vm = new Vue({ directives: { autoEnter: { inserted: function(el) { el.value = "strick"; } } } }); script>
也可以在创建Vue实例之前,通过Vue.directive()方法注册全局指令,如下所示。
Vue.directive("autoEnter", { inserted: function(el) { el.value = "strick"; } }); var vm = new Vue({...});
2)定义对象
在指令的定义对象中,有5个钩子函数,其使用方法如表2所述。
表2 钩子函数
钩子函数 | 调用时机 | 调用次数 |
bind() | 指令首次绑定到元素时调用 | 一次 |
inserted() | 绑定元素插入到父节点时调用,此时不能保证元素已在DOM中 | 一次 |
update() | 绑定该指令的组件更新时调用,其子组件此时可能还未更新,并且绑定值可能有变化,也可能保持不变 | 多次 |
componentUpdated() | 绑定该指令的组件及其子组件都完成更新后调用 | 多次 |
unbind() | 指令与元素解绑时调用 | 一次 |
接下来自定义一个v-hooks指令,并为其添加4个钩子函数,作用于
是
<div v-if="display" v-hooks="name"> <p>{{age}}p> div> <script> var vm = new Vue({ data: { name: "strick", display: true, age: 28 }, directives: { hooks: { bind: function() { console.log("bind"); }, inserted: function() { console.log("inserted"); }, update: function(el, binding) { console.log("update", binding.value, binding.oldValue); }, unbind: function() { console.log("unbind"); } } } }); script>
当在浏览器中首次加载时,控制台会依次输出“bind”和“inserted”。
如果修改v-hooks指令的值(如下代码所示),那么就会调用update()函数,并输出指令的新值(value)和旧值(oldValue),分别是"freedom"和"strick"。
vm.name = "freedom";
此时再修改子元素
中的插值(如下代码所示),那么仍然会调用update()函数,只是指令的新值和旧值都是“freedom”。
vm.age = 30;
当通过v-if指令销毁元素时(如下代码所示),就会调用unbind()函数,并输出“unbind”。
vm.display = false;
当bind()和update()触发的行为相同时,Vue允许将指令的定义对象声明成一个函数,如下所示。
Vue.directive("func", function (el, binding) { console.log("function"); });
3)参数
钩子函数可接收4个参数:el、binding、vnode和oldVnode,参数说明如下所列。注意,除了el之外,其它参数都是只读的。
(1)el:指令所绑定的元素。
(2)binding:一个对象,其属性如表3所列,举例参照的是自定义的v-hooks指令。
(3)vnode:Vue编译生成的虚拟节点。
(4)oldVnode:上一个虚拟节点,只存在于update()和componentUpdated()函数中。
表3 binding对象
属性 | 描述 |
name | 指令名称,不包含“v-”前缀,例如hooks |
rawName | 指令的原始名称,包含“v-”前缀、参数和修饰符,例如v-hooks:click.once |
value | 指令接收的值,例如在v-hooks="name"中,读取name属性得到的值为“strick” |
oldValue | 指令接收的旧值,即上一个值,只在update()和componentUpdated()函数中可用 |
expression | 字符串类型的指令表达式,例如v-hooks="name"中的“name” |
arg | 传给指令的参数,例如v-hooks:click中的“click” |
oldArg | 传给指令的上一个参数,与oldValue一样,只在update()和componentUpdated()函数中可用 |
modifiers | 包含修饰符的对象,例如在v-hooks.once.self中,修饰符对象为{once: true, self: true} |
自定义指令可接收任意合法的JavaScript表达式,包括对象,并且还支持动态参数,如下所示。
<p v-calculate:[arg]="{left:10, right:20}">p> <script> var vm = new Vue({ data: { arg: "click" }, directives: { calculate: { bind: function(el, binding) { console.log(binding.arg); //"click" console.log(binding.value); //{left: 10, right: 20} } } } }); script>