8个非常实用的Vue自定义指令

在 Vue , 除了核心功能默认内置的指令 ( v-model 和 v-show ) , Vue 也允许注册自定义指令 。它的作用价值在于当开发人员在某些场景下需要对普通 DOM 元素进行操作 。
Vue自定义指令有全局注册和局部注册两种方式 。先来看看注册全局指令的方式 , 通过 Vue.directive( id, [definition] ) 方式注册全局指令 。然后在入口文件中进行 Vue.use() 调用 。
【8个非常实用的Vue自定义指令】批量注册指令 , 新建 directives/index.js 文件
import copy from './copy'import longpress from './longpress'// 自定义指令const directives = {copy,longpress,} export default {install(Vue) {Object.keys(directives).forEach((key) => {Vue.directive(key, directives[key])})},}复制代码在 main.js 引入并调用
import Vue from 'vue'import Directives from './JS/directives'Vue.use(Directives)复制代码指令定义函数提供了几个钩子函数(可选):

  • bind: 只调用一次 , 指令第一次绑定到元素时调用 , 可以定义一个在绑定时执行一次的初始化动作 。
  • inserted: 被绑定元素插入父节点时调用(父节点存在即可调用 , 不必存在于 document 中) 。
  • update: 被绑定元素所在的模板更新时调用 , 而不论绑定值是否变化 。通过比较更新前后的绑定值 。
  • componentUpdated: 被绑定元素所在模板完成一次更新周期时调用 。
  • unbind: 只调用一次 ,  指令与元素解绑时调用 。
下面分享几个实用的 Vue 自定义指令
  • 复制粘贴指令 v-copy
  • 长按指令 v-longpress
  • 输入框防抖指令 v-debounce
  • 禁止表情及特殊字符 v-emoji
  • 图片懒加载 v-LazyLoad
  • 权限校验指令 v-premission
  • 实现页面水印 v-waterMarker
  • 拖拽指令 v-draggable
v-copy需求:实现一键复制文本内容 , 用于鼠标右键粘贴 。
思路:
  1. 动态创建 textarea 标签 , 并设置 readOnly 属性及移出可视区域
  2. 将要复制的值赋给 textarea 标签的 value 属性 , 并插入到 body
  3. 选中值 textarea 并复制
  4. 将 body 中插入的 textarea 移除
  5. 在第一次调用时绑定事件 , 在解绑时移除事件
const copy = {bind(el, { value }) {el.$value = https://www.isolves.com/it/cxkf/qd/2022-02-25/valueel.handler = () => {if (!el.$value) {// 值为空的时候 , 给出提示 。可根据项目UI仔细设计console.log('无复制内容')return}// 动态创建 textarea 标签const textarea = document.createElement('textarea')// 将该 textarea 设为 readonly 防止 IOS 下自动唤起键盘 , 同时将 textarea 移出可视区域textarea.readOnly = 'readonly'textarea.style.position = 'absolute'textarea.style.left = '-9999px'// 将要 copy 的值赋给 textarea 标签的 value 属性textarea.value = el.$value// 将 textarea 插入到 body 中document.body.AppendChild(textarea)// 选中值并复制textarea.select()const result = document.execCommand('Copy')if (result) {console.log('复制成功') // 可根据项目UI仔细设计}document.body.removeChild(textarea)}// 绑定点击事件 , 就是所谓的一键 copy 啦el.addEventListener('click', el.handler)},// 当传进来的值更新的时候触发componentUpdated(el, { value }) {el.$value = value},// 指令与元素解绑的时候 , 移除事件绑定unbind(el) {el.removeEventListener('click', el.handler)},} export default copy复制代码使用:给 Dom 加上 v-copy 及复制的文本即可
<template><button v-copy="copyText">复制</button></template> <script> export default {data() {return {copyText: 'a copy directives',}},} </script>复制代码v-longpress需求:实现长按 , 用户需要按下并按住按钮几秒钟 , 触发相应的事件
思路:
  1. 创建一个计时器 ,  2 秒后执行函数
  2. 当用户按下按钮时触发 mousedown 事件 , 启动计时器;用户松开按钮时调用 mouseout 事件 。
  3. 如果 mouseup 事件 2 秒内被触发 , 就清除计时器 , 当作一个普通的点击事件
  4. 如果计时器没有在 2 秒内清除 , 则判定为一次长按 , 可以执行关联的函数 。


    推荐阅读