Vue3自定义指令完全指南(附详细代码)

 更新时间:2025年04月27日 09:00:23   作者:john_Asura  
这篇文章主要介绍了Vue3自定义指令的相关资料,Vue3自定义指令优化了生命周期钩子,提供了更灵活的DOM操作方式,文中通过代码介绍的非常详细,需要的朋友可以参考下

基本概念

在Vue3中,自定义指令是用于直接操作DOM的重要工具。相比Vue2,Vue3的指令系统进行了优化和简化。

生命周期钩子

钩子名称对应Vue2名称触发时机
createdbind元素属性绑定前
beforeMountinserted元素插入父节点前
mounted-元素插入父节点后
beforeUpdateupdate组件更新前
updatedcomponentUpdated组件及子组件更新后
beforeUnmountunbind元素卸载前
unmounted-元素卸载后

指令注册方式

全局注册

// main.js
const app = createApp(App)

app.directive('focus', {
  mounted(el) {
    el.focus()
  }
})

局部注册

export default {
  directives: {
    highlight: {
      mounted(el, binding) {
        el.style.backgroundColor = binding.value || 'yellow'
      }
    }
  }
}

常用应用场景

1. 自动聚焦

// 使用
<input v-focus>

// 实现
app.directive('focus', {
  mounted(el) {
    el.focus()
  }
})

2. 权限控制

// 使用
<button v-permission="['admin']">删除</button>

// 实现
app.directive('permission', {
  mounted(el, binding) {
    const roles = ['user', 'editor', 'admin']
    if (!binding.value.includes(roles.current)) {
      el.parentNode.removeChild(el)
    }
  }
})

3. 防抖指令

// 使用
<button v-debounce:click="submitForm">提交</button>

// 实现
app.directive('debounce', {
  mounted(el, binding) {
    let timer = null
    el.addEventListener(binding.arg, () => {
      clearTimeout(timer)
      timer = setTimeout(() => {
        binding.value()
      }, 500)
    })
  }
})

进阶技巧

动态参数传递

// 使用
<div v-pin:[direction]="200"></div>

// 实现
app.directive('pin', {
  mounted(el, binding) {
    el.style.position = 'fixed'
    const direction = binding.arg || 'top'
    el.style[direction] = binding.value + 'px'
  }
})

Composition API 结合

import { useScroll } from './scrollComposable'

app.directive('scroll', {
  mounted(el, binding) {
    const { start, stop } = useScroll(binding.value)
    el._scrollHandler = { start, stop }
    start()
  },
  unmounted(el) {
    el._scrollHandler.stop()
  }
})

注意事项

  • 避免过度使用:优先使用组件化方案
  • 参数验证:使用binding.value前进行类型检查
  • 性能优化:及时在unmounted阶段清理副作用
  • 命名规范:使用小写字母+连字符格式(如v-custom-directive
  • 浏览器兼容:谨慎使用新API,必要时添加polyfill

总结

场景推荐指令类型示例
DOM操作自定义指令v-tooltip
全局功能全局指令v-permission
复杂交互组合式指令v-draggable
简单样式修改类绑定:class=“…”

通过合理使用自定义指令,可以使代码更简洁、维护性更好,但要注意保持指令的单一职责原则。

到此这篇关于Vue3自定义指令的文章就介绍到这了,更多相关Vue3自定义指令内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue或react项目生产环境去掉console.log的操作

    vue或react项目生产环境去掉console.log的操作

    这篇文章主要介绍了vue或react项目生产环境去掉console.log的操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-09-09
  • Vue3插槽(slot)使用方法详解

    Vue3插槽(slot)使用方法详解

    在VUE开发项目的过程中,插槽<slot>是重要的承载分发内容的出口,下面这篇文章主要给大家介绍了关于Vue3插槽(slot)使用的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-11-11
  • vue跳转页面携带参数并且立即执行方法

    vue跳转页面携带参数并且立即执行方法

    这篇文章主要介绍了vue跳转页面携带参数并且立即执行方法,首先定义跳转函数,结合实例代码给大家介绍的非常详细,需要的朋友参考下吧
    2023-10-10
  • vue 动态组件component

    vue 动态组件component

    这篇文章主要介绍了 vue 动态组件component ,vue提供了一个内置的<component>,专门用来实现动态组件的渲染,这个标签就相当于一个占位符,需要使用is属性指定绑定的组件,想了解更多详细内容的小伙伴请参考下面文章的具体内容
    2021-11-11
  • 关于vue自适应布局(各种浏览器,分辨率)的示例代码

    关于vue自适应布局(各种浏览器,分辨率)的示例代码

    这篇文章主要介绍了vue自适应布局(各种浏览器,分辨率),主要使用了flex布局的flex:1属性和自适应的css+vh+百分比这种方式,开局设置overflow:hidden,主体main部分要设置:overflow:auto,需要的朋友可以参考下
    2022-09-09
  • vue实力踩坑 当前页push当前页无效的解决

    vue实力踩坑 当前页push当前页无效的解决

    这篇文章主要介绍了vue实力踩坑 当前页push当前页无效的解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-04-04
  • Echarts+VUE柱状图绘制细节并且屏幕自适应完整代码

    Echarts+VUE柱状图绘制细节并且屏幕自适应完整代码

    柱状图(或称条形图)是一种通过柱形的长度来表现数据大小的一种常用图表类型,这篇文章主要给大家介绍了关于Echarts+VUE柱状图绘制细节并且屏幕自适应的相关资料,需要的朋友可以参考下
    2024-02-02
  • vue-router中query和params的区别解析

    vue-router中query和params的区别解析

    vue-router是Vue.js官方的路由插件,它和vue.js是深度集成的,适合用于构建单页面应用,这篇文章主要介绍了vue-router中query和params的区别 ,需要的朋友可以参考下
    2022-10-10
  • 浅谈vue3中ref、toRef、toRefs 和 reactive的区别

    浅谈vue3中ref、toRef、toRefs 和 reactive的区别

    本文主要介绍了浅谈vue3中ref、toRef、toRefs 和 reactive的区别,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-07-07
  • 使用Axios拦截器中止Vue请求的步骤详解

    使用Axios拦截器中止Vue请求的步骤详解

    假设 App 的用户可以在短时间内进行多个 API 调用,但您只想显示上次调用的结果,之前正在进行的请求变得无关紧要,在这种情况下,您可以利用 Axios 拦截器,本文给大家介绍了如何使用Axios拦截器中止Vue请求,需要的朋友可以参考下
    2023-11-11

最新评论