詳解vue自定義指令

一.背景

除了核心功能默認內置的指令 (v-model 和 v-show)，Vue 也允許註冊自定義指令。注意，在 Vue2.0 中，代碼複用和抽象的主要形式是組件。然而，有的情況下，你仍然需要對普通 DOM 元素進行底層操作，這時候就會用到自定義指令

二.自定義指令基本用法

1.全局註冊

// 註冊一個全局自定義指令 `v-focus`
Vue.directive('focus', {
  // 當被綁定的元素插入到 DOM 中時……
  inserted: function (el) {
    // 聚焦元素
    el.focus()
  }
})

2.組件內註冊

directives: {
  focus: {
    // 指令的定義
    inserted: function (el) {
      el.focus()
    }
  }
}

3.然後你可以在模板中任何元素上使用新的 v-focus 屬性，如下：

<input v-focus>

三.鉤子函數

bind 只調用一次，指令第一次綁定到元素時調用。在這裏可以進行一次性的初始化設置。
inserted 被綁定元素插入父節點時調用 (僅保證父節點存在，但不一定已被插入文檔中)
update 所在組件的 VNode 更新時調用，但是可能發生在其子 VNode 更新之前。指令的值可能發生了改變，也可能沒有。但是你可以通過比較更新前後的值來忽略不必要的模板更新 (詳細的鉤子函數參數見下)

指令鉤子函數會被傳入以下參數：

• 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 編譯生成的虛擬節點。
• oldVnode：上一個虛擬節點，僅在 update 和 componentUpdated 鉤子中可用。

四.用法

如果把自己常用的公共操作dom的方法，都採用自定義的方式進行維護,很方便的。

<div id="dynamicexample">
  <h3>Scroll down inside this section ↓</h3>
  <p v-pin:[direction]="200">I am pinned onto the page at 200px to the left.</p>
</div>



Vue.directive('pin', {
  bind: function (el, binding, vnode) {
    el.style.position = 'fixed'
    var s = (binding.arg == 'left' ? 'left' : 'top')
    el.style[s] = binding.value + 'px'
  }
})

new Vue({
  el: '#dynamicexample',
  data: function () {
    return {
      direction: 'left'
    }
  }
})