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开发树形结构组件(组件递归)

    这篇文章主要为大家详细介绍了vue开发树形结构组件的方法,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-08-08
  • vue2中seo时使用vue-meta-info的方法

    vue2中seo时使用vue-meta-info的方法

    这篇文章主要介绍了vue2中seo时使用vue-meta-info,本文通过实例代码给大家详细讲解,文末给大家补充介绍了vue seo管理 vue-meta-info 动态设置meta和title的相关知识,需要的朋友可以参考下
    2022-10-10
  • Vue3 给 reactive 响应式对象赋值的实现

    Vue3 给 reactive 响应式对象赋值的实现

    在Vue3中,可以使用reactive函数创建响应式对象,如果你想给这个响应式对象赋值,可以直接修改其属性,下面就来介绍一下reactive响应式对象赋值的实现,感兴趣的可以了解一下
    2025-09-09
  • antd中table展开行默认展示,且不需要前边的加号操作

    antd中table展开行默认展示,且不需要前边的加号操作

    这篇文章主要介绍了antd中table展开行默认展示,且不需要前边的加号操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-11-11
  • Vue之Axios异步通信详解

    Vue之Axios异步通信详解

    这篇文章主要为大家介绍了Vue之Axios异步通信,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2021-11-11
  • Vue3实现clipboard复制的使用示例

    Vue3实现clipboard复制的使用示例

    在日常开发中,为用户提供复制文本功能的需求比较常见,下面介绍一款vue3可用的插件,可以快速实现这个功能,感兴趣的可以了解一下
    2023-11-11
  • vue-resource + json-server模拟数据的方法

    vue-resource + json-server模拟数据的方法

    本篇文章主要介绍了vue-resource + json-server模拟数据的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-11-11
  • Vue快速实现通用表单验证的方法

    Vue快速实现通用表单验证的方法

    这篇文章主要介绍了Vue快速实现通用表单验证的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-02-02
  • Vue实现动态创建和删除数据的方法

    Vue实现动态创建和删除数据的方法

    下面小编就为大家分享一篇Vue实现动态创建和删除数据的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-03-03
  • 用Vue.js开发网页时钟

    用Vue.js开发网页时钟

    这篇文章主要为大家详细介绍了用Vue.js开发一个网页时钟,分为白天模式和夜晚模式,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-08-08

最新评论