Vue_自定义指令
關于Vue的自定義指令:
- 在Vue中除了核心功能默認內置的指令(v-model & v-show)
- Vue也允許注冊自定義指令。
注意,在 Vue2.0 中,代碼復用和抽象的主要形式是組件。然而,有的情況下,你仍然需要對普通 DOM 元素進行底層操作,這時候就會用到自定義指令。舉個聚焦輸入框的例子,
例如:
我們當前頁面只有一個input框
在頁面加載時,該元素將獲取焦點。什么意思呢?
就是說,在我們打開該頁面,還未點擊任何內容時,這個輸入框就已經處于聚焦狀態。
看代碼:
<!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 來使用你剛剛定義好的指令了。
?
一個指令定義對象可以提供如下幾個鉤子函數(均為可選):
-
bind:只調用一次,指令第一次綁定到元素時調用。在這里可以進行一次性的初始化設置。
-
inserted:被綁定元素插入父節點時調用 (僅保證父節點存在,但不一定已被插入文檔中)。
-
update:所在組件的 VNode 更新時調用,但是可能發生在其子 VNode 更新之前。指令的值可能發生了改變,也可能沒有。但是你可以通過比較更新前后的值來忽略不必要的模板更新 (詳細的鉤子函數參數見下)。
-
componentUpdated:指令所在組件的 VNode?及其子 VNode?全部更新后調用。
-
unbind:只調用一次,指令與元素解綁時調用。
接下來我們來看一下鉤子函數的參數 (即?el、binding、vnode?和?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!' } }) |
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
轉載于:https://www.cnblogs.com/ugfly/p/8353915.html
超強干貨來襲 云風專訪:近40年碼齡,通宵達旦的技術人生總結
- 上一篇: 数组排序(选择排序和冒泡排序)
- 下一篇: react native 生成APK