Vue3自定义插件实现全局Loading效果过程

 更新时间:2026年03月11日 16:07:53   作者:1024小神  
文章介绍了如何在Vue项目中实现一个全局的loading效果,通过创建一个loading组件,并将其封装成一个插件,在main.ts中进行全局挂载,使得在应用的任何地方都可以通过`LOADING`属性来控制loading状态,最后在App.vue中引用该插件,从而实现全局loading效果

使用组件的形式

实现全局loading效果:

在项目中添加一个文件夹

plugin/loading,并新建一个loading.vue组件:

loading.vue组件代码:

<template>
  <div v-if="loading" class="loading">Loading</div>
</template>

<script setup lang="ts">
import { ref } from 'vue'

const loading = ref(false)

const show = () => {
  loading.value = true
  console.log('show方法执行了')
}

const hide = () => {
  loading.value = false
  console.log('hide方法执行了')
}

defineExpose({
  show,
  hide
})
</script>

<style scoped>
.loading {
  position: fixed;
  top: 0;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 30px;
  width: 100vw;
  height: 100vh;
  opacity: 0.5;
  background-color: grey;
  color: white;
  z-index: 999;
}
</style>

新建一个index.ts插件文件

将loading组件加载进去,并且给vue对象全局挂载LOADING属性

import type { App } from 'vue'
import { createVNode, render } from 'vue'
import loading from './loadIng.vue'

export default {
  install(app: App) {
    console.log('全局Loadig插件执行了')
    // 将vue组件转为VNode,然后渲染到页面上
    const VNode = createVNode(loading)
    render(VNode, document.body)
    // 给Vue对象全局挂载属性show、hide
    app.config.globalProperties.LOADING = {
      show: VNode.component?.exposed?.show,
      hide: VNode.component?.exposed?.hide
    }
    console.log('挂载点属性:', VNode.component?.exposed, app.config.globalProperties.LOADING)
  }
}

在main.ts中挂载这个组件

在main.ts中声明LOADING属性

import './assets/main.css'

import { createApp } from 'vue'
import { createPinia } from 'pinia'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import App from './App.vue'
import router from './router'
import loading from './plugin/loading'

const app = createApp(App)

app.use(createPinia())
app.use(router)
// 自定义插件全局loading
app.use(loading)

app.use(ElementPlus)
// 定义全局变量和全局函数
app.config.globalProperties.env = "dev"

app.config.globalProperties.filter = {
  format<T>(content:T){
    return "格式化后的内容" + content
  }
}

// 解决Vue中的全局变量和函数报错问题
interface Filter {
  format<T>(content:T):string
}


interface LOADING {
  show():null
  hide():null
}


declare module 'vue' {
  export interface ComponentCustomProperties {
    filter: Filter,
    env:string,
    LOADING:LOADING
  }
}



app.mount('#app')

在App.vue中引用这个插件

<template>
  <div class="app">
    主页测试全局loading插件
    <button @click="showLoading">点击加载loading</button>
  </div>
</template>

<script setup lang="ts">
import { getCurrentInstance } from 'vue'

const app = getCurrentInstance()

const showLoading = ()=>{
  // const app = getCurrentInstance()
  app?.proxy?.LOADING.show()
  console.log("点击了loading", app);
  // 5秒之后取消加载
  setTimeout(() => {
    app?.proxy?.LOADING.hide()
  }, 5000);
}


</script>

<style scoped>
.app{
  width: 100vw;
  height: 100vh;
  font-size: 30px;
  background-color: orange;
}
</style>

最后的效果就是: 

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。 

相关文章

  • Vue中使用vue-plugin-hiprint插件进行打印的功能实现

    Vue中使用vue-plugin-hiprint插件进行打印的功能实现

    hiprint 是一个web 打印的js组件,无需安装软件,支持windows,macOS,linux 系统,支持移动端,PC端浏览器,angular,vue,react 等 分页预览,打印,操作简单,运行快速,本文介绍了Vue中使用vue-plugin-hiprint插件进行打印,需要的朋友可以参考下
    2025-04-04
  • 基于vue项目设置resolves.alias: ''@''路径并适配webstorm

    基于vue项目设置resolves.alias: ''@''路径并适配webstorm

    这篇文章主要介绍了基于vue项目设置resolves.alias: '@'路径并适配webstorm,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-12-12
  • Vue.js组件使用props传递数据的方法

    Vue.js组件使用props传递数据的方法

    这篇文章主要为大家详细介绍了Vue.js组件使用props传递数据的方法,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-10-10
  • vue3中的事件修饰符详解

    vue3中的事件修饰符详解

    Vue3中的事件修饰符包括:.stop(阻止冒泡)、.prevent(阻止默认事件)、.self(阻止自身事件)、.capture(打乱冒泡顺序)、.once(事件只触发一次)和.passive(事件默认行为立即执行),这些修饰符可以帮助开发者更灵活地控制事件的处理方式
    2025-02-02
  • vue定时器设置和关闭页面时关闭定时器方式

    vue定时器设置和关闭页面时关闭定时器方式

    这篇文章主要介绍了vue定时器设置和关闭页面时关闭定时器方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-06-06
  • vuex的使用和简易实现

    vuex的使用和简易实现

    这篇文章主要介绍了vuex的使用和简易实现,帮助大家更好的理解和使用vuex,感兴趣的朋友可以了解下
    2021-01-01
  • vue如何集成raphael.js中国地图的方法示例

    vue如何集成raphael.js中国地图的方法示例

    最近的数据统计项目中要用到中国地图,也就是在地图上动态的显示某个时间段某个省份地区的统计数据,我们不需要flash,仅仅依靠raphael.js以及SVG图像就可以完成地图的交互操作。本文就给大家介绍了关于利用vue集成raphael.js中国地图的相关资料,需要的朋友可以参考下。
    2017-08-08
  • vue LogicFlow更多配置选项示例详解

    vue LogicFlow更多配置选项示例详解

    这篇文章主要为大家介绍了vue LogicFlow更多配置选项详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-01-01
  • vue实现数字滚动效果

    vue实现数字滚动效果

    这篇文章主要为大家详细介绍了vue实现数字滚动效果,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-06-06
  • vue写一个组件

    vue写一个组件

    这篇文章主要介绍了vue组写一个组件,需要的朋友可以参考下
    2018-04-04

最新评论