指令钩子函数会被传入以下参数:
- el:指令所绑定的元素,可以用来直接操作 DOM 。
- binding:一个对象,包含以下属性:vnode:Vue 编译生成的虚拟节点。移步 VNode API 来了解更多详情。
- ◦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 }。
- oldVnode:上一个虚拟节点,仅在 update 和 componentUpdated 钩子中可用。
具体事例
clickoutside.js
用途:clickoutside.js主要用于解决点解元素外的地方时执行函数 主要应用的常见有弹出层点击遮罩层是隐藏窗口,或者一些弹出层点击其他地方要消失的场景
v-clickoutside具体是怎么实现的
答:主要是通过在bind中定义函数 通过判断是否包含元素,执行binding.value函数
document.addEventListener('click',documentHandler)
},update (el,binding) {
},unbind(el) {
document.removeEventListener('click',documentHandler);
}
}
Vue.directive使用注意
首先,Vue.directive要在实例初始化之前,不然会报错,还有,定义的指令不支持驼峰式写法,也会报下面同样的错,虽然在源码中没有找到在哪里统一处理大小写,但是在有关directive的方法中捕捉到的指令命名统一变为小写,所以,还是用'-'或者'_'分割吧。
vue.js:491 [Vue warn]: Failed to resolve directive: xxx
然后,其定义方式有两种,一种是Vue.directive('xxx',function(el,bind,vNode){}),其中el为dom,vNode为vue的虚拟dom,bind为一较复杂对象,详情可见Vue-directive钩子函数中的参数的参数,还有一种,为
参数代表的含义,参见钩子函数描述
最后,要使用自定义的指令,只需在对用的元素中,加上'v-'的前缀形成类似于内部指令'v-if','v-text'的形式。
当然,也可以将method中的方法加入,bind.value即为methods中的方法。
<script type="text/javascript">
// Vue.directive
Vue.directive('test_directive',vNode){
el.style.color = bind.value();
});
var app = new Vue({
el: '#app',methods: {
add: function(){
this.num++;
},changeColor: function(){
return this.color;
}
}
});</pre>