DIV CSS 佈局教程網

Vue.JS 入門教程之自定義指令
編輯:JavaScript技巧     

基礎

Vue.js 允許你注册自定義指令,本質上是讓你教 Vue 一些新技巧:如何把資料的變化映射到 DOM 的行為。你可以用 Vue.directive(id, definition) 方法,傳入指令 id 和定義物件來注册一個全域自定義指令。定義物件需要提供一些鉤子函式(全部可選):

  • bind:僅調用一次,在指令第一次綁定元素時。
  • update:第一次緊跟在 bind 之後調用,參數是綁定的初始值;之後每當綁定的值發生變化就會被調用,獲得新值與舊值兩個參數。
  • unbind:僅調用一次,在指令解綁元素時。

例子:

 Vue.directive('my-directive', { bind: function () { // 做綁定的準備工作 // 比如添加事件監聽器,或是其他只需要執行一次的複雜操作 }, update: function (newValue, oldValue) { // 根據獲得的新值執行對應的更新 // 對於初始值也會被調用一次 }, unbind: function () { // 做清理工作 // 比如移除在 bind() 中添加的事件監聽器 } }) 

一旦注册好自定義指令,你就可以在 Vue.js 模板中這樣使用它(需要添加 Vue.js 的指令前綴,預設為 v-):

<div v-my-directive="someValue"></div>

如果你只需要 update 函式,可以只傳入一個函式,而不傳定義物件:

 Vue.directive('my-directive', function (value) { // 這個函式會被作為 update() 函式使用 }) 

所有的鉤子函式會被複製到實際的指令物件中,而這個指令物件將會是所有鉤子函式的 this 上下文環境。指令物件上暴露了一些有用的公開屬性:

el:指令綁定的元素
vm:擁有該指令的上下文 ViewModel
expression:指令的表達式,不包括參數和過濾器
arg:指令的參數
raw:未被解析的原始表達式
name:不帶前綴的指令名

這些屬性是唯讀的,不要修改它們。你也可以給指令物件附加自定義的屬性,但注意不要覆蓋已有的內部屬性。

使用指令物件屬性的範例:

 <!DOCTYPE html> <html> <head lang="en"> <meta charset="UTF-8"> <title></title> <script src="https://cdnjs.cloudflare.com/ajax/libs/vue/0.12.16/vue.min.js"></script> </head> <body> <div id="demo" v-demo-directive="LightSlateGray : msg"></div> <script> Vue.directive('demoDirective', { bind: function () { this.el.style.color = '#fff' this.el.style.backgroundColor = this.arg }, update: function (value) { this.el.innerHTML = 'name - ' + this.name + '<br>' + 'raw - ' + this.raw + '<br>' + 'expression - ' + this.expression + '<br>' + 'argument - ' + this.arg + '<br>' + 'value - ' + value } }); var demo = new Vue({ el: '#demo', data: { msg: 'hello!' } }) </script> </body> </html> 

多重從句

在同一個特性內部,逗號分隔的多個從句會被綁定為多個指令實例。下面的例子中,指令會被建立和調用兩次:

<div v-demo="color: 'white', text: 'hello!'"></div>

如果想要用單個指令實例處理多個參數,可以利用字面量物件作為表達式:

<div v-demo="{color: 'white', text: 'hello!'}"></div>

 Vue.directive('demo', function (value) { console.log(value) // Object {color: 'white', text: 'hello!'} }) 

字面指令

如果在建立自定義指令時傳入 isLiteral: true,那麼特性值就會被看成直接字串,並被賦值給該指令的 expression。字面指令不會嘗試建立資料監視。
例子:

<div v-literal-dir="foo"></div>

 Vue.directive('literal-dir', { isLiteral: true, bind: function () { console.log(this.expression) // 'foo' } }) 

動態字面指令

然而,在字面指令含有 Mustache 標簽的情形下,指令的行為如下:

指令實例會有一個屬性,this._isDynamicLiteral 被設為 true;

如果沒有提供 update 函式,Mustache 表達式只會被求值一次,並將該值賦給 this.expression,不會對表達式進行資料監視。

如果提供了 update 函式,指令將會為表達式建立一個資料監視,並在計算結果變化時調用 update。

雙向指令

如果你的指令想向 Vue 實例寫回資料,你需要傳入 twoWay: true。該選項允許在指令中使用 this.set(value)。

 Vue.directive('example', { twoWay: true, bind: function () { this.handler = function () { // 把資料寫回 vm // 如果指令這樣綁定 v-example="a.b.c", // 這裡將會給 `vm.a.b.c` 賦值 this.set(this.el.value) }.bind(this) this.el.addEventListener('input', this.handler) }, unbind: function () { this.el.removeEventListener('input', this.handler) } }) 

內聯語句

傳入 acceptStatement: true 可以讓自定義指令像 v-on 一樣接受內聯語句:

<div v-my-directive="a++"></div>

 Vue.directive('my-directive', { acceptStatement: true, update: function (fn) { // the passed in value is a function which when called, // will execute the "a++" statement in the owner vm's // scope. } }) 

但請明智地使用此功能,因為通常我們希望避免在模板中產生副作用。

深度資料觀察

如果你希望在一個物件上使用自定義指令,並且在物件內部嵌套的屬性發生變化時也能觸發指令的 update 函式,那麼你要在指令的定義中傳入 deep: true。

<div v-my-directive="obj"></div>

 Vue.directive('my-directive', { deep: true, update: function (obj) { // 當 obj 內部嵌套的屬性變化時也會調用此函式 } }) 

指令優先級

你可以選擇給指令提供一個優先級數(預設是 0)。同一個元素上優先級越高的指令,會比其他指令處理得早一些。優先級一樣的指令會按照其在元素特性列表中出現的順序依次處理,但不能保證這個順序在不同瀏覽器中是相同的。

一般來說,作為使用者你並不需要關心內建指令的優先級,如果你感興趣,可以參閱原始碼。邏輯控制指令 v-repeat、v-if 被視為「終結性指令」,它們在編譯過程中始終擁有最高的優先級。

元素指令

有時候,我們可能希望指令能以自定義元素的形式被使用,而不是作為一個特性。這與 Angular 的 E 類指令概念非常相似。元素指令可以看作一個輕量的自定義元件(後面會講到)。你可以像下面這樣注册一個自定義的元素指令:

 Vue.elementDirective('my-directive', { // 和普通指令的 API 一致 bind: function () { // 對 this.el 進行操作... } }) 

使用時我們不再用這樣的寫法:

<div v-my-directive></div>

而是寫成:

<my-directive></my-directive>

元素指令不能接受參數或表達式,但它可以讀取元素的特性來決定行為。與一般指令有個很大的不同:元素指令是終結性的,這意味著一旦 Vue 遇到一個元素指令,它將跳過對該元素和其子元素的編譯——即只有該元素指令本身可以操作該元素及其子元素。

以上就是本文的全部內容,希望對你的學習有所幫助。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved