Vue_自定義指令

關於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:只調用一次,指令與元素解綁時調用。

接下來咱們來看一下鉤子函數的參數 (即 elbindingvnode 和 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: 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: '#hook-arguments-example',
data: {
message: 'hello!'
}
})
name: "demo"
value: "hello!"
expression: "message"
argument: "foo"
modifiers: {"a":true,"b":true}
vnode keys: tag, data, children, text, elm, ns, context, fnContext, fnOptions, fnScopeId, key, componentOptions, componentInstance, parent, raw, isStatic, isRootInsert, isComment, isCloned, isOnce, asyncFactory, asyncMeta, isAsyncPlaceholder

函數簡寫

在不少時候,你可能想在 bind 和 update 時觸發相同行爲,而不關心其它的鉤子。好比這樣寫:

Vue.directive('color-swatch', function (el, binding) {
el.style.backgroundColor = binding.value
})

對象字面量

若是指令須要多個值,能夠傳入一個 JavaScript 對象字面量。記住,指令函數可以接受全部合法的 JavaScript 表達式。

<div v-demo="{ color: 'white', text: 'hello!' }"></div>
Vue.directive('demo', function (el, binding) {
console.log(binding.value.color) // => "white"
console.log(binding.value.text) // => "hello!"
})

 

參考連接:https://cn.vuejs.org/v2/guide/custom-directive.html

相關文章
相關標籤/搜索