先来一个简单的自定义指令,给元素添加一个背景色
注册自定义指令分为全局注册与局部注册
局部注册
通过组件的 directives 属性，对该组件添加一个局部的指令。
//html
<div v-red>局部注册背景色指令</div>
//javascript
<script>
export default{
directives: {
red: {
inserted(el, binding, vnode, oldVnode){
el.style.background = "red"
}
}
}
}
</script>
全局注册
通过 Vue.directive() 函数注册一个全局的指令。
1.新建src/directive/pink/index.js,并写入如下内容
const pink = (Vue) => {
Vue.directive("pink", {
inserted: (el, binding, vnode, oldVnode) => {
el.style.background = "pink"
}
})
}
export default pink
2.在main.js中引入并使用
import Vue from 'vue'
import pink from "@/directive/pink";
Vue.use(pink)
3.然后就可以安心食用了
<div v-pink>全局注册背景色指令</div>
动态指令参数
指令的参数可以是动态的。例如，在 v-mydirective:[argument]="value" 中，argument 参数可以根据组件实例数据进行更新！这使得自定义指令可以在应用中被灵活使用。
比如下面这个指令,实现了把元素相对于窗口的上下左右定位
// posit.js
const posit = {
bind(el, binding) {
el.style.position = 'fixed'
let s = binding.arg
debugger
// let s = 'top'
el.style[s] = binding.value + 'px'
}
}
export default posit
使用如下:
<template>
<div>
<div>带参数的自定义指令</div>
<span v-yel>背景变黄指令</span>
<div v-posit:[positionValue]="200">带参数的自定义指令--定位在离上方200px处</div>
<div v-posit:left="500">带参数的自定义指令--定位在离左侧500px处</div>
<div v-posit:right="200">带参数的自定义指令--定位在离右侧200px处</div>
<div v-posit:bottom="200">带参数的自定义指令--定位在离下方200px处</div>
</div>
</template>
<script>
import posit from './posit'
import yellow from './yellow'
export default {
name: "directive-2",
directives: {
posit,
yel: yellow
},
data() {
return {
positionValue: 'top'
}
}
}
</script>
动态指令参数
由上面这个例子可知:
- 可以局部定义多个指令
- 动态指令可以直接指定,如
<div v-posit:left="500">带参数的自定义指令--定位在离左侧500px处</div>
也可以通过属性动态指定,如<div v-posit:[positionValue]="200">带参数的自定义指令--定位在离上方200px处</div>
防止按钮重复点击指令
这个是看到其他人写的,感觉很实用,记录一下
//preventReClick.js
const preventReClick = function(Vue) {
Vue.directive('preventReclick', {
inserted: function(el, binding) {
el.addEventListener('click', () => {
if (!el.disabled) {
el.disabled = true
setTimeout(() => {
el.disabled = false
}, binding.value || 3000)
}
})
}
})
}
export default preventReClick
也是在main.js引入注册一下,然后就可以食用了
import preventReClick from '@/directive/preventReClick'
Vue.use(preventReClick)
<el-button v-preventReclick @click="submit">
钩子函数
指令定义函数提供了几个钩子函数（可选）：
- 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 }。
- vnode: Vue 编译生成的虚拟节点。
- oldVnode: 上一个虚拟节点，仅在 update 和 componentUpdated 钩子中可用。
网友评论