站長(zhǎng)資訊網(wǎng)
除了默認(rèn)設(shè)置的核心指令( v-model 和 v-show )，Vue 也允許注冊(cè)自定義指令。在Vue里，代碼復(fù)用的主要形式和抽象是組件。然而，有的情況下，仍然需要對(duì)純 DOM 元素進(jìn)行底層操作，這時(shí)候就會(huì)用到自定義指令。本文將詳細(xì)介紹Vue自定義指令
指令注冊(cè)
以一個(gè)input元素自動(dòng)獲得焦點(diǎn)為例，當(dāng)頁(yè)面加載時(shí)，使用autofocus可以讓元素將獲得焦點(diǎn) 。但是autofocus在移動(dòng)版Safari上不工作?，F(xiàn)在注冊(cè)一個(gè)使元素自動(dòng)獲取焦點(diǎn)的指令
指令注冊(cè)類(lèi)似于組件注冊(cè)，包括全局指令和局部指令兩種
【全局指令】
使用Vue.diretive()來(lái)全局注冊(cè)指令
// 注冊(cè)一個(gè)全局自定義指令 v-focusVue.directive('focus', { // 當(dāng)綁定元素插入到 DOM 中。 inserted: function (el) { // 聚焦元素 el.focus() } })
【局部指令】
也可以注冊(cè)局部指令，組件或Vue構(gòu)造函數(shù)中接受一個(gè) directives 的選項(xiàng)
var vm = new Vue({ el: '#example', directives:{ focus:{ inserted: function (el) { el.focus() } } } })
然后可以在模板中任何元素上使用新的 v-focus 屬性
<p id="example"> <input v-focus></p>
<script>// 注冊(cè)一個(gè)全局自定義指令 v-focusVue.directive('focus', { // 當(dāng)綁定元素插入到 DOM 中。 inserted: function (el) { // 聚焦元素 el.focus() } })var vm = new Vue({ el: '#example', })</script>
鉤子函數(shù)
指令定義函數(shù)提供了幾個(gè)鉤子函數(shù)（可選）
【bind】
只調(diào)用一次，指令第一次綁定到元素時(shí)調(diào)用，用這個(gè)鉤子函數(shù)可以定義一個(gè)在綁定時(shí)執(zhí)行一次的初始化動(dòng)作
【inserted】
被綁定元素插入父節(jié)點(diǎn)時(shí)調(diào)用（父節(jié)點(diǎn)存在即可調(diào)用，不必存在于 document 中）
【update】
所在組件的 VNode 更新時(shí)調(diào)用，但是可能發(fā)生在其孩子的 VNode 更新之前。指令的值可能發(fā)生了改變也可能沒(méi)有。但是可以通過(guò)比較更新前后的值來(lái)忽略不必要的模板更新
【componentUpdated】
所在組件的 VNode 及其孩子的 VNode 全部更新時(shí)調(diào)用
【unbind】
只調(diào)用一次， 指令與元素解綁時(shí)調(diào)用
鉤子函數(shù)參數(shù)
鉤子函數(shù)被賦予了以下參數(shù)
【el】
指令所綁定的元素，可以用來(lái)直接操作 DOM
【binding】
一個(gè)對(duì)象，包含以下屬性：
name: 指令名，不包括 v- 前綴。 value: 指令的綁定值， 例如： v-my-directive="1 + 1", value 的值是 2。 oldValue: 指令綁定的前一個(gè)值，僅在 update 和 componentUpdated 鉤子中可用。無(wú)論值是否改變都可用。 expression: 綁定值的字符串形式。 例如 v-my-directive="1 + 1" ， expression 的值是 "1 + 1"。 arg: 傳給指令的參數(shù)。例如 v-my-directive:foo， arg 的值是 "foo"。 modifiers: 一個(gè)包含修飾符的對(duì)象。 例如： v-my-directive.foo.bar, 修飾符對(duì)象 modifiers 的值是 { foo: true, bar: true }。
【vnode】
Vue 編譯生成的虛擬節(jié)點(diǎn)
【oldVnode】
上一個(gè)虛擬節(jié)點(diǎn)，僅在 update 和 componentUpdated 鉤子中可用
[注意]除了 el 之外，其它參數(shù)都是只讀的，盡量不要修改他們。如果需要在鉤子之間共享數(shù)據(jù)，建議通過(guò)元素的 dataset 來(lái)進(jìn)行
下面是一個(gè)使用了這些參數(shù)的自定義鉤子樣例
<p id="example" v-demo:foo.a.b="message"></p>
<script>Vue.directive('demo', { bind: function (el, binding, vnode) { var s = JSON.stringify el.innerHTML = 'name: ' + s(binding.name) + '<br>' + 'value: ' + s(binding.value) + '<br>' + 'expression: ' + s(binding.expression) + '<br>' + 'argument: ' + s(binding.arg) + '<br>' + 'modifiers: ' + s(binding.modifiers) + '<br>' + 'vnode keys: ' + Object.keys(vnode).join(', ') } })new Vue({ el: '#example', data: { message: 'hello!' } })</script>
【函數(shù)簡(jiǎn)寫(xiě)】
大多數(shù)情況下，可能想在bind和update鉤子上做重復(fù)動(dòng)作，并且不想關(guān)心其它的鉤子函數(shù)?？梢赃@樣寫(xiě)：
Vue.directive('color-swatch', function (el, binding) { el.style.backgroundColor = binding.value })
【對(duì)象字面量】
如果指令需要多個(gè)值，可以傳入一個(gè)JS對(duì)象字面量。指令函數(shù)能夠接受所有合法類(lèi)型的JS表達(dá)式
<p v-demo="{ color: 'white', text: 'hello!' }"></p>
Vue.directive('demo', function (el, binding) { console.log(binding.value.color) // => "white" console.log(binding.value.text) // => "hello!" })
