目录

一、什么是自定义指令

二、全局自定义指令directive

三、局部自定义指令directives

四、自定义指令的调用

五、自定义指令的钩子函数

六、自定义指令传参

七、常见自定义指令

---

一、什么是自定义指令

vue官方提供很多指令，如：v-model，v-show，v-if，v-if等，他们都以v-开头。当这些指令不能满足我们实际开发需求时，我们还可以自定义指令。自定义指令主要分为全局自定义指令和局部自定义指令。

二、全局自定义指令directive

在main.js中写全局自定义指令

// 自动获取焦点
Vue.directive('focus', {
  inserted: function (el) {
    el.focus()
  }
})

三、局部自定义指令directives

可以在任意组件中定义自定义指令，directives是一个对象，他的每一个属性就只一个自定义指令，这里定义了一个focus指令。

directives: {
  focus: {
    inserted: function (el) {
      el.focus()
    }
  }
}

四、自定义指令的调用

和普通指令的使用方式一样v-自定义指令名称

如v-focus

五、自定义指令的钩子函数

有以下五个钩子函数：

• bind：只调用一次，指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。

• inserted：被绑定元素插入父节点时调用 (仅保证父节点存在，但不一定已被插入文档中)。

• update：所在组件的 VNode 更新时调用，但是可能发生在其子 VNode 更新之前。指令的值可能发生了改变，也可能没有。但是你可以通过比较更新前后的值来忽略不必要的模板更新。

• componentUpdated：指令所在组件的 VNode 及其子 VNode 全部更新后调用。

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

每个钩子函数有以下参数：

• el：指令所绑定的元素，可以用来直接操作 DOM。
• binding：一个对象，包含以下 property：
  • 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 编译生成的虚拟节点。
• oldVnode：上一个虚拟节点，仅在 update 和 componentUpdated 钩子中可用。

注意：bind和insert都只调用一次；bind在insert前执行，也就是bind在dom树绘制前调用，insert在dom树绘制后调用；涉及dom操作的，我们一般都用insert，如自动获取焦点指令，只能用insert函数。

六、自定义指令传参

<div v-test:[data1]>这是测试页。。。。</div>

可以用binding.arg去接收":"后的参加参数，这里传递了data1这个变量，data1必须用[]包裹，否则就是‘data1’这个字符串，[]中只能传递一个变量，多个变量可以用对象或数组组装。binding.value去接收"="后的参数，这里是个函数所以用bingding.value()去调用。

        <div v-test:[data1]='func'>这是测试页。。。。</div>

        test: {
			inserted(el, binding, vnode) {
				// 获取参数
				console.log('test',binding.arg);
				// 执行传递的函数
				binding.value({success: true,data:{}});
			},
		}

七、常见自定义指令

  1、拖拽

        dragV: {
			bind(drag, binding, vNode) {
				drag.style.position = 'absolute';
				drag.style.zIndex = '9999';
				//当鼠标按下时
				drag.onmousedown = e => {
					//做到浏览器兼容
					e = e || window.event  
					let diffX = e.clientX - drag.offsetLeft
					let diffY = e.clientY - drag.offsetTop
					//当拉着box移动时
					document.onmousemove = e => {
						// 浏览器兼容
						e = e || window.event;
						let left = e.clientX - diffX;
						let top = e.clientY - diffY;
						drag.style.left = left + 'px';
						drag.style.top = top + 'px';
					}
					// 当鼠标抬起时
					document.onmouseup = function() {
						this.onmousemove = null
						this.onmouseup = null
					}
				}
			}
		},

2、防抖

        <div v-debounce:[time]="debounceFunc">这是测试页。。。。</div>

        debounce:{
			inserted(el, binding) {
				let timer;
				let delay = binding.arg || 500;
				el.addEventListener('click', () => {
					if (timer) {
						clearTimeout(timer)
					}
					timer = setTimeout(() => {
						binding.value()
					}, delay)
				})
			},
		}