除了 Vue 內建指令,開發者也可以註冊自定義指令,用來把資料變化映射成特定的 DOM 行為。自定義指令特別適合處理需要直接操作元素的情境。
可以使用 Vue.directive 註冊全域指令,也可以在元件的 directives 選項中註冊區域指令。註冊時需要提供指令名稱與定義物件。
Vue.directive('my-directive', {
bind: function () {},
update: function (newValue, oldValue) {},
unbind: function () {}
});
其中 bind 會在指令第一次綁定到元素時呼叫,update 會在值變化時呼叫,unbind 則會在指令解除綁定時呼叫。
在指令的鉤子函式中,this 會指向指令物件。常見屬性包含 el、vm、expression、arg、name、modifiers 與 descriptor。這些屬性可協助開發者取得元素、所屬實例與指令表達式等資訊。
若指令需要傳入多個值,可以使用 JavaScript 物件字面量。若使用字面修飾符,則指令值會被當成普通字串處理,不會隨資料變化而更新。
除了以屬性形式使用,自定義指令也可以做成自定義元素。元素指令適合需要整體接管元素行為的情境,但它通常不接受參數或表達式。
自定義指令能大幅擴充 Vue 的模板能力,但應避免在指令中過度依賴 DOM 細節,以免降低可維護性。