首页 > 其他分享 >Vue技巧大揭秘:自定义指令的力量与应用

Vue技巧大揭秘:自定义指令的力量与应用

时间:2024-07-03 23:56:53浏览次数:28  
标签:el Vue 自定义 指令 注册 组件 揭秘

引言

自定义指令就像是给予开发者的一把魔法钥匙,它能够打开DOM操作的新世界,按我的理解就是把对DOM操作的逻辑进行封装

全局注册与局部注册

全局注册

定义: 全局注册意味着自定义指令在Vue实例创建之前通过Vue.directive()方法注册,一旦注册,就可以在任意组件的模板中使用该指令。

适用场景

  • 当自定义指令在多个组件中都需要使用时。
  • 当你想要创建一个全局可用的行为,比如一个自定义的拖拽指令。

优点

  • 方便:只需注册一次,就可以在任何组件中使用。
  • 管理简单:所有指令集中注册,便于维护。

缺点

  • 不灵活:全局注册的指令在所有组件中都是可用的,可能会导致不必要的全局污染。
  • 不可配置:所有使用该指令的地方都会受到相同的指令行为影响。

局部注册

定义: 局部注册是在单个组件内部通过组件的directives选项注册的,这意味着指令只在该组件内有效。

适用场景

  • 当自定义指令只在一个组件内使用时。
  • 当你需要为不同的组件提供不同行为的指令时。

优点

  • 灵活:可以根据组件的需要注册和使用指令。
  • 可配置:可以在不同的组件中为同一个指令提供不同的配置。
  • 避免污染:不会影响到其他组件,减少了全局空间的占用。

缺点

  • 重复:如果在多个组件中使用相同的指令,需要在每个组件中重复注册。
  • 维护难度:指令分散在各个组件中,随着项目规模的增大,可能会导致维护难度增加。

实际操作示范

全局注册(与new Vue同级)

如何进行全局注册

全局注册是在Vue实例化之前进行的,通常在入口文件中,如main.jsapp.js。使用Vue.directive()方法来注册一个全局指令。

代码示例和步骤说明
// main.js
import Vue from 'vue';
import App from './App.vue';

// 全局注册自定义指令
Vue.directive('focus', {
  // 钩子函数
  inserted: function (el) {
    el.focus();
  }
});

new Vue({
  el: '#app',
  render: h => h(App)
});

在上面的代码中,我们定义了一个名为focus的全局指令,它在元素插入到DOM后自动聚焦该元素。

全局注册的应用场景

全局注册适用于那些在多个组件中都需要使用的指令,比如一个控制输入框自动聚焦的指令。

<!-- 在任何组件中使用全局注册的指令 -->
<template>
  <input v-focus>
</template>

局部注册(与methods同级)

如何进行局部注册

局部注册是在组件内部进行的,通过在组件的directives选项中定义指令。

代码示例和步骤说明
// 局部注册自定义指令
export default {
  name: 'MyComponent',
  directives: {
    'local-focus': {
      // 钩子函数
      inserted: function (el) {
        el.focus();
      }
    }
  },
  // ...
};

在上面的代码中,我们定义了一个名为local-focus的局部指令,它仅在MyComponent组件内部有效。

局部注册的应用场景

局部注册适用于那些仅在一个组件内部使用的指令,比如一个特定组件的特定行为。

<!-- 在组件内部使用局部注册的指令 -->
<template>
  <input v-local-focus>
</template>

指令的钩子函数

Vue中的自定义指令提供了几个钩子函数,这些函数允许你在不同阶段操纵DOM,或对DOM进行一些操作。以下是自定义指令的钩子函数,以及它们的作用和使用场景:

  1. bind: 在指令第一次绑定到元素上时调用。在这里可以进行一次性的初始化设置,例如添加事件监听器或初始化样式。

  2. inserted: 被绑定元素插入父节点时调用(仅保证父节点存在,但不一定已被插入文档中)。例如,如果你需要访问元素的尺寸或位置,这个钩子很有用。

  3. update: 所在组件的VNode更新时调用,但是可能发生在其子VNode更新之前。当你需要根据组件的状态更新指令的行为时,可以使用这个钩子。

  4. componentUpdated(updata的补充版本): 在指令所在组件的VNode及其子VNode全部更新后调用。如果你需要在所有子组件都更新后执行某些操作,这个钩子很有用。

  5. unbind: 只调用一次,指令与元素解绑时调用。在这里可以进行一些清理工作,例如移除事件监听器。

使用场景示例

  • bind: 设置初始样式或绑定事件监听器。
  • inserted: 自动聚焦输入框或执行与元素位置相关的操作。
  • update: 根据组件状态更新元素样式或内容。
  • componentUpdated: 在所有子组件更新后执行某些操作,例如调整滚动位置。
  • unbind: 清理工作,例如移除事件监听器或取消定时器。

代码示例

Vue.directive('example', {
  bind: function (el, binding, vnode) {
    // 初始化操作
  },
  inserted: function (el, binding, vnode) {
    // 元素插入父节点后的操作
  },
  update: function (el, binding, vnode, oldVnode) {
    // 组件更新时的操作
  },
  componentUpdated: function (el, binding, vnode, oldVnode) {
    // 组件及其子组件更新完成后的操作
  },
  unbind: function (el, binding, vnode) {
    // 指令解绑时的操作
  }
});

指令的参数和修饰符 

 

参数(Argument)

指令参数通常用于指定指令的行为或选项。在指令中使用参数时,需要在指令名称后面用冒号(:)分隔。例如,v-my-directive:arg中的arg就是参数。

使用场景
  • 当你需要根据不同的条件执行不同的指令逻辑时。
  • 当你需要传递一个值或配置项给指令时。
示例

假设我们有一个自定义指令v-tooltip,用于显示工具提示,我们可以通过参数指定工具提示的方向:

<p v-tooltip:"top">鼠标悬停显示顶部工具提示</p>
<p v-tooltip:"bottom">鼠标悬停显示底部工具提示</p>

在指令定义中,我们可以通过binding.arg获取参数值:

Vue.directive('tooltip', {
  bind: function (el, binding) {
    // 根据参数设置工具提示的方向
    el.style[binding.arg] = '10px';
  }
});

修饰符(Modifier)

修饰符是以点(.)开头的特殊标记,用于指示指令应该以特殊方式绑定。修饰符可以改变指令的行为,或者为指令提供额外的信息。

使用场景
  • 当你需要为指令提供额外的配置选项时。
  • 当你需要改变指令的默认行为时。
示例

假设我们有一个自定义指令v-click-outside,用于在点击元素外部时触发事件。我们可以通过修饰符来指定是否阻止事件冒泡:

<div v-click-outside.stop>点击外部时触发事件,并阻止事件冒泡</div>

在指令定义中,我们可以通过binding.modifiers获取修饰符对象:

Vue.directive('click-outside', {
  bind: function (el, binding) {
    // 为元素添加点击事件监听器
    el.addEventListener('click', function (event) {
      // 如果有修饰符@stop,则阻止事件冒泡
      if (binding.modifiers.stop) {
        event.stopPropagation();
      }
      // 执行指令逻辑
    });
  }
});

 总结

Vue自定义指令允许开发者封装DOM操作逻辑,全局和局部注册提供了灵活性。指令钩子在不同生命周期操作DOM,参数和修饰符增强了指令的定制能力。这些特性有助于创建高效、可维护的自定义指令。
创作不易,您的每一个点赞和评论都是我创作的动力!

标签:el,Vue,自定义,指令,注册,组件,揭秘
From: https://blog.csdn.net/a3098448071/article/details/140137765

相关文章

  • [大疆航线] 系列(2) 基于KML或WPML文件的航点动作设计与自定义航线
    关键词:无人机航线、航点动作、kml航线文件,wpml航线软件作者:ludwig1860日期:2024.7.31.KML的高级使用如果需要精准控制每个航点以及航点处的动作,就需要对KML文件进行调整。怎么调整呢?从DJIPilot地面站软件中自行编辑一个满足自己所有调整需求的航线(仅包含几个航点即可,目......
  • vue3 toref ref toRow unref等等使用和功能测试
    代码测试js代码constrowData=reactive({nameAbc:'sdfsdf'})console.log(rowData,"rowData")letrowDataValue=toRaw(rowData);console.log(rowDataValue,"rowdatavalue")//toRefs使对象本身转为普通对象,但是子属性全部转为refvalue方式//toRef......
  • 从零开始的Django+vue项目实战(1)
    Introduction这个系列的blog是为哈工大(威海)的企业与服务智能计算研究中心(ICES)的纳新培训任务准备的,但是也适合想学习django并快速上手项目的友友。我们培训的目的要使新人学会web前后端开发。培训PPT里给出了用springboot和vue3来实现,但是如今django也愈发流行,为了弥补P......
  • java使用sshd 实现sftp 自定义显示目录
       pom.xml<dependencies><dependency><groupId>cn.hutool</groupId><artifactId>hutool-core</artifactId><version>5.8.28</version></dependency>......
  • Vue3实战笔记(64)—Vue 3自定义指令的艺术:实战中的最佳实践
    文章目录前言一、一些简单的Vue3自定义指令超实用案例总结前言书接上文,在Vue3中,自定义指令是一种强大的工具,允许我们扩展HTML元素的功能。通过自定义指令,我们可以创建可重用的行为,并将它们绑定到任何元素上。下面,本文备份一些简单的Vue3自定义指令超实用案例,并解释......
  • activiti流程配置——vue整合bpmn.js
    acitivti提供了流程图绘制的应用,可以整合到流程项目钟。但是现在很多项目都是前后端分离,vue前端开发比较多。所以,我用vue整合了一下bpmn。具体的整合过程,网上有大把的资料可以参考;我这边就不罗列了。我主要记录一下,vue整合bpmn过程中,对于activiti流程而言有几个地方要注意:......
  • 关于自定义unordered_set\unordered_map中Hash和KeyEqual:函数对象和lambda表达式简单
    以unordered_set为例,首先在cppreference中查看其模板定义:可以看到Hash类默认是std::hash<Key,KeyEqual类似,本文将Hash以函数对象写出,将KeyEqual以lambda写出。classhashvec{ public: size_toperator()(constvector<int>&vec)const{ returnhash<int>()(vec[0])+hash......
  • 如何理解vuex中的每个概念(通俗易懂)
    文章目录1.什么是Vuex?2.Vuex的四个核心概念1.什么是Vuex?想象一下,你家里有一个大冰箱,所有家庭成员都可以访问这个冰箱。每个人都可以往里面放东西,也可以从里面拿东西。这个冰箱就像是Vuex中的“状态”,每个家庭成员(Vue组件)都可以共享这个状态。2.Vuex的......
  • 初学vue3, 全是黑盒子,vue3知识点汇总
    学习Vue.js应该像学习一门编程语言一样,首先要熟练掌握常用的知识,而对于不常用的内容可以简单了解一下。先对整个框架和语言有一个大致的轮廓,然后再逐步补充细节。千万不要像学习算法那样,一开始就钻牛角尖。前序:vueAPI的风格分为:选项式和组合式,vue2中一般用选项式,所以文章......
  • 揭秘JWT:从CTF实战到Web开发,使用JWT令牌验证
    揭秘JWT:从CTF实战到Web开发,使用JWT令牌验证介绍JWT(JSONWebTokens)是一种开放标准(RFC7519),它定义了一种紧凑且自包含的方式,用于在网络上安全地传输信息。这种信息可以验证和信任,因为它是数字签名的。JWT可以使用HMAC算法或者是RSA的公私秘钥对进行签名。「优点」:「无状态」:服......