Vue.directive 自定义指令

Posted 2021-03-13 mary-123

// 注册一个全局自定义指令 `v-focus`
Vue.directive(‘focus‘, {
  // 当被绑定的元素插入到 DOM 中时……
  inserted: function (el) {
    // 聚焦元素
    el.focus()
  }
})

局部
directives: {
  focus: {
    // 指令的定义
    inserted: function (el) {
      el.focus()
    }
  }
}

页面使用

<input v-focus>

自定义指令中传递的三个参数

el: 指令所绑定的元素，可以用来直接操作DOM。

binding: 一个对象，包含指令的多个属性信息。

vnode: Vue编译生成的虚拟节点。

oldVnode： 上一个虚拟节点，仅在 update 和 componentUpdated 钩子中可用。

除了 el 之外，其它参数都应该是只读的，切勿进行修改。

如果需要在钩子之间共享数据，建议通过元素的 dataset 来进行。

自定义指令的生命周期

自定义指令有五个生命周期（也叫钩子函数），分别是 bind， inserted， update， componentUpdated， unbind

1、bind：只调用一次，指令第一次绑定到元素时调用，用这个钩子函数可以定义一个绑定时执行一次的初始化动作。

2、inserted：被绑定元素插入父节点时调用（父节点存在即可调用，不必存在于document中）。

3、update：被绑定于元素所在的模板更新时调用，而无论绑定值是否变化。通过比较更新前后的绑定值，可以忽略不必要的模板更新。

4、componentUpdated：被绑定元素所在模板完成一次更新周期时调用。

5、unbind：只调用一次，指令与元素解绑时调用。

Vue.directive(‘my-directive‘, {
  bind: function () {},
  inserted: function () {},
  update: function () {},
  componentUpdated: function () {},
  unbind: function () {}
}

示例一：拖拽自定义指令

Vue.directive(‘drag‘, {
        inserted:function(el){
            el.onmousedown=function(e){
                let l=e.clientX-el.offsetLeft;
                let t=e.clientY-el.offsetTop;
                document.onmousemove=function(e){
                    el.style.left=e.clientX-l+‘px‘;
                    el.style.top=e.clientY-t+‘px‘;
                };
                el.onmouseup=function(){
                    document.onmousemove=null;
                    el.onmouseup=null;
                }
            }
        }
    })

 示例二

Vue.directive(‘img‘,{
    //DOM
    inserted:function(el,binding){
        var color =Math.floor(Math.random()*1000000);
        el.style.backgroundColor = ‘#‘ + color;
        var img = new Image();
        img.src = binding.value;
        img.onload = function(){
            el.style.backgroundImage = ‘url(‘ + binding.value + ‘)‘;
        }
    }
})
<div v-img="val.url" v-for="val in list"></div>
//此处图片路径为示意结果，为了能够更好的看出本段测试代码的效果，建议大家选择网上比较高清的图片
list:[
    {url:‘1.jpg‘},
    {url:‘1.jpg‘},
    {url:‘1.jpg‘}
]