Vue.js 自定義指令
除了預設設定的核心指令( v-model 和 v-show ), Vue 也允許註冊自定義指令。
下面我們註冊一個全域性指令 v-focus, 該指令的功能是在頁面載入時,元素獲得焦點:
例項
<div id="app">
<p>頁面載入時,input 元素自動獲取焦點:</p>
<input v-focus>
</div>
<script>
// 註冊一個全域性自定義指令 v-focus
Vue.directive('focus', {
// 當繫結元素插入到 DOM 中。
inserted: function (el) {
// 聚焦元素
el.focus()
}
})
// 建立根例項
new Vue({
el: '#app'
})
</script>
我們也可以在例項使用 directives 選項來註冊區域性指令,這樣指令只能在這個例項中使用:
例項
<div id="app">
<p>頁面載入時,input 元素自動獲取焦點:</p>
<input v-focus>
</div>
<script>
// 建立根例項
new Vue({
el: '#app',
directives: {
// 註冊一個區域性的自定義指令 v-focus
focus: {
// 指令的定義
inserted: function (el) {
// 聚焦元素
el.focus()
}
}
}
})
</script>
鉤子
鉤子函式
指令定義函式提供了幾個鉤子函式(可選):
bind
: 只調用一次,指令第一次繫結到元素時呼叫,用這個鉤子函式可以定義一個在繫結時執行一次的初始化動作。inserted
: 被繫結元素插入父節點時呼叫(父節點存在即可呼叫,不必存在於 document 中)。update
: 被繫結元素所在的模板更新時呼叫,而不論繫結值是否變化。通過比較更新前後的繫結值,可以忽略不必要的模板更新(詳細的鉤子函式引數見下)。componentUpdated
: 被繫結元素所在模板完成一次更新週期時呼叫。unbind
: 只調用一次, 指令與元素解綁時呼叫。
鉤子函式引數
鉤子函式的引數有:
- el: 指令所繫結的元素,可以用來直接操作 DOM 。
- binding: 一個物件,包含以下屬性:
- name: 指令名,不包括
v-
字首。 - value: 指令的繫結值, 例如:
v-my-directive="1 + 1"
, value 的值是2
。 - oldValue: 指令繫結的前一個值,僅在
update
和componentUpdated
鉤子中可用。無論值是否改變都可用。 - expression: 繫結值的表示式或變數名。 例如
v-my-directive="1 + 1"
, expression 的值是"1 + 1"
。 - arg: 傳給指令的引數。例如
v-my-directive:foo
, arg 的值是"foo"
。 - modifiers: 一個包含修飾符的物件。 例如:
v-my-directive.foo.bar
, 修飾符物件 modifiers 的值是{ foo: true, bar: true }
。
- name: 指令名,不包括
- vnode: Vue 編譯生成的虛擬節點。
- oldVnode: 上一個虛擬節點,僅在
update
和componentUpdated
鉤子中可用。
以下例項演示了這些引數的使用:
例項
<div id="app" v-itread01:hello.a.b="message">
</div>
<script>
Vue.directive('itread01', {
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: '#app',
data: {
message: '入門教學!'
}
})
</script>
有時候我們不需要其他鉤子函式,我們可以簡寫函式,如下格式:
Vue.directive('itread01', function (el, binding) { // 設定指令的背景顏色 el.style.backgroundColor = binding.value.color })
指令函式可接受所有合法的 JavaScript 表示式,以下例項傳入了 JavaScript 物件:
例項
<div id="app">
<div v-itread01="{ color: 'green', text: '入門教學!' }"></div>
</div>
<script>
Vue.directive('itread01', function (el, binding) {
// 簡寫方式設定文字及背景顏色
el.innerHTML = binding.value.text
el.style.backgroundColor = binding.value.color
})
new Vue({
el: '#app'
})
</script>