Vue不僅內置了各類指令,包括條件渲染、事件處理等,還能注冊自定義指令。
一、條件渲染
條件渲染的指令包括v-if、v-else、v-else-if和v-show。
1)v-if
該指令的功能和條件語句中的if類似,可根據表達式的計算結果,判斷是否渲染分支中的元素和它所包含的子元素。在下面的示例中,當把數據對象的exist屬性設為true時,<div>和<p>兩個元素就會被添加到頁面的DOM中。
<div v-if="exist"> <p>strick</p> </div> <script> var vm = new Vue({ data: { exist: true } }); </script>
當需要通過v-if指令渲染多個元素,並且不必指定包裹元素時,就得使用Vue提供的<template>元素了,如下代碼所示。其功能類似於React的Fragments,也可生成一個不可見的包裹元素,並且在最終的DOM中,不會包含<template>元素。
<template v-if="exist"> <p>strick</p> <p>freedom</p> </template>
2)v-else
該指令的功能和條件語句中的else類似,需要與v-if配合使用,並且要緊跟在v-if或v-else-if之后(如下所示),否則該指令將失效。
<p v-if="exist">strick</p> <p v-else>freedom</p>
3)v-else-if
該指令與v-else類似,也需要緊跟在v-if或v-else-if之后,但它能自定義條件表達式,如下所示。
<p v-if="digit==1">strick</p> <p v-else-if="digit==2">justify</p> <p v-else>freedom</p>
4)v-show
該指令能根據表達式的計算結果顯示或隱藏當前元素,如果得到的結果是一個假值,那么會為元素添加內聯樣式“display: none;”,如下所示。
<!-- <p style="display: none;">strick</p> --> <p v-show="false">strick</p>
v-if會在切換過程中創建或銷毀可能包含的數據綁定和子元素,並且只有在條件為真時,才會渲染該分支中的元素。而v-show無論條件的真假都會渲染元素,很適合頻繁切換,並且要注意,v-show既不能作用於<template>元素,也無法與v-else配合。由前面的分析可知,v-if有更高的切換開銷而v-show有更高的初始渲染開銷。
二、列表渲染
v-for是一個用於列表渲染的指令,它能接收數組、對象和整數,並且支持<template>元素。
1)數組
當基於數組來渲染一個列表時,v-for指令可迭代數組的元素和其索引。下面是一個示例,在第一組<li>元素中,item是元素的別名,迭代語法和for-in循環語句類似;在第二組<li>元素中,向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算法快速找到變化的節點,並且高效的將其插入到新位置,而不用渲染無變化的元素。可以像下面這樣為每個<li>元素設置一個key特性,其值為peoples數組中的元素對象的id屬性。
<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()方法用於打印接收的參數,<section>元素添加了.stop和.self兩個修飾符。
<div @click="print('div')"> <section @click.stop.self="print('section')"> <button @click="print('button')">點擊</button> </section> </div>
當將@click.stop.self作用於<section>元素時,點擊按鈕只會輸出“button”,因為先執行.stop就會阻止所有元素發起的事件傳播;當將@click.self.stop作用於<section>元素時,點擊按鈕會依次輸出“button”和“div”,因為先執行.self就只會阻止<section>元素發起的事件傳播。
除了事件修飾符之外,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>元素,如下所示,其中<p>是<div>的子元素。
<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";
此時再修改子元素<p>中的插值(如下代碼所示),那么仍然會調用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>