關於Vue的自定義指令:html
- 在Vue中除了核心功能默認內置的指令(v-model & v-show)
vue
- Vue也容許註冊自定義指令。node
注意,在 Vue2.0 中,代碼複用和抽象的主要形式是組件。然而,有的狀況下,你仍然須要對普通 DOM 元素進行底層操做,這時候就會用到自定義指令。舉個聚焦輸入框的例子,express
例如:api
咱們當前頁面只有一個input框app
在頁面加載時,該元素將獲取焦點。什麼意思呢?async
就是說,在咱們打開該頁面,還未點擊任何內容時,這個輸入框就已經處於聚焦狀態。ide
看代碼:函數
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> <script src="../vue.js"></script> </head> <body> <div id="app"> <input type="text" v-foc> </div> <script> new Vue({ el:'#app', data:{}, directives:{ // 註冊局部自定義命令 foc:{ // 自定義指令的名字:v-foc inserted:function (t) { // 該指令的定義 t.focus(); t.style.backgroundColor = '#1232'; t.style.color = 'yellow' } } } }) </script> </body> </html>
至此:你就能夠經過在頁面上寫入 v-foc 來使用你剛剛定義好的指令了。ui
一個指令定義對象能夠提供以下幾個鉤子函數(均爲可選):
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
來進行。
這是一個使用了這些屬性的自定義鉤子樣例:
<div id="hook-arguments-example" v-demo:foo.a.b="message"></div> |
Vue.directive('demo', { |
在不少時候,你可能想在 bind
和 update
時觸發相同行爲,而不關心其它的鉤子。好比這樣寫:
Vue.directive('color-swatch', function (el, binding) { |
若是指令須要多個值,能夠傳入一個 JavaScript 對象字面量。記住,指令函數可以接受全部合法的 JavaScript 表達式。
<div v-demo="{ color: 'white', text: 'hello!' }"></div> |
Vue.directive('demo', function (el, binding) { |
參考連接:https://cn.vuejs.org/v2/guide/custom-directive.html