自定義指令
> 自定義指令分為全局自定義指令和局部自定義指令
> 先嘗試一下自定義指令的寫法
~~~javascript
// 注冊一個全局自定義指令 `v-focus`
Vue.directive('focus', {
// 當被綁定的元素插入到 DOM 中時……
inserted: function (el) {
// 聚焦元素
el.focus()
}
})
~~~
如果想注冊局部指令,組件中也接受一個 directives 的選項:
~~~javascript
directives: {
focus: {
// 指令的定義
inserted: function (el) {
el.focus()
}
}
}
~~~
### 鉤子函數
> 一個指令定義對象可以提供如下幾個鉤子函數 (均為可選)
* bind:只調用一次,指令第一次綁定到元素時調用。在這里可以進行一次性的初始化設置。
* inserted:被綁定元素插入父節點時調用 (僅保證父節點存在,但不一定已被插入文檔中)。
* update:所在組件的 VNode 更新時調用,但是可能發生在其子 VNode 更新之前。指令的值可能發生了改變,也可能沒有。但是你可以通過比較更新前后的值來忽略不必要的模板更新 (詳細的鉤子函數參數見下)。
* componentUpdated:指令所在組件的 VNode 及其子 VNode 全部更新后調用。
* unbind:只調用一次,指令與元素解綁時調用。
> 接下來我們來看一下鉤子函數的參數 (即 el、binding、vnode 和 oldVnode)。
### 鉤子函數參數
指令鉤子函數會被傳入以下參數:
* el:指令所綁定的元素,可以用來直接操作 DOM 。
* binding:一個對象,包含以下屬性:
* name:指令名,不包括 v- 前綴。
* value:指令的綁定值,例如:v-my-directive="1 + 1" 中,綁定值為 2。
* oldValue:指令綁定的前一個值,僅在 update 和 componentUpdated 鉤子中可用。無論值是否改變都可用。
* expression:字符串形式的指令表達式。例如 v-my-directive="1 + 1" 中,表達式為 "1 + 1"。
* arg:傳給指令的參數,可選。例如 v-my-directive:foo 中,參數為 "foo"。
* modifiers:一個包含修飾符的對象。例如:v-my-directive.foo.bar 中,修飾符對象為 { foo: true, bar: true }。
* vnode:Vue 編譯生成的虛擬節點。移步 VNode API 來了解更多詳情。
* oldVnode:上一個虛擬節點,僅在 update 和 componentUpdated 鉤子中可用。
* 除了 el 之外,其它參數都應該是只讀的,切勿進行修改。如果需要在鉤子之間共享數據,建議通過元素的 dataset 來進行。