Vue 应用的加载状态管理:如何统一控制全局 Loading?

酷静小哥_2807

酷静小哥_2807

2026-06-21

223人浏览

原创

统一控制全局 loading 的关键是状态集中管理、请求生命周期对齐与防错乱,采用计数器机制(非布尔值)、axios 拦截器自动触发、最小显示时长防闪动,并支持按需开启及组件级状态上报。

vue 应用的加载状态管理:如何统一控制全局 loading?

统一控制全局 Loading 的关键不是“让每个地方都调用一次 show/hide”,而是把加载状态变成可追踪、可聚合、可自动响应的系统行为。核心在于:状态集中管理 + 请求生命周期对齐 + 防止状态错乱。

用计数器代替布尔值,避免提前关闭

单纯用 isLoading = true/false 会出问题——比如两个请求并发,第一个很快结束并设为 false,Loading 就消失了,但第二个还在跑。正确做法是维护一个请求数量计数器:

  • 每次请求发起时,计数器 +1;若原值为 0,则显示 Loading
  • 每次响应(成功或失败)后,计数器 -1;若减到 0,则隐藏 Loading
  • 推荐在 Pinia store 或 Vuex 中实现该逻辑,例如:state.count 和配套的 startLoading() / endLoading() action
  • 额外加个最小显示时长(如 300ms),防止闪动:隐藏前用 setTimeout 延迟执行,但仅当计数器已归零时才真正关闭

通过 Axios 拦截器自动触发,不侵入业务代码

不需要在每个 API 调用前后手动写 loading 控制。把逻辑收口到拦截器里:

vue-component-analyzer
vue-component-analyzer

递归分析 Vue 项目组件依赖,从入口文件生成组件层级图,支持 Vue 2/3,输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。

下载
  • 请求拦截器中判断 config.showLoading !== false,满足条件就调用 store.startLoading()
  • 响应拦截器中统一调用 store.endLoading(),包括错误分支也必须执行
  • 支持按需开启:默认 GET 不触发,提交类请求(POST/PUT/DELETE)自动启用,也可显式传 { showLoading: true }
  • 避免重复触发:拦截器内做防重入检查,同一时刻只允许一个 loading 实例存在

让组件“上报”而非“接管”,解耦更干净

大型项目中,不同模块可能同时发起请求。与其让每个组件自己管 loading,不如让它向全局注册自己的状态:

  • Pinia store 维护一个数组 loadingSources,存各组件的响应式引用(如 ref(true))
  • 组件 onMounted 时调用 addLoadingSource(ref(true)),onUnmounted 时调用 removeLoadingSource
  • store 用 computed 计算 isLoading = sources.some(toValue),自动响应任意组件状态变化
  • 组件卸载自动清理,不会内存泄漏;多个组件共存时,只要有一个为 true,Loading 就保持显示

结合 UI 组件库,快速落地不造轮子

Element Plus、Ant Design Vue 等都提供现成的全屏 loading 服务,直接集成即可:

  • Element Plus:用 ElLoading.service({ fullscreen: true }) 创建实例,.close() 关闭
  • Ant Design Vue:用 $message.loading('加载中...'),配合 key 手动关闭,或封装成单例管理
  • 不建议直接在模板里写 v-loading 控制局部区域——全局 Loading 的目标是遮罩整个视图,不是分散控制
  • 样式定制统一在 service 配置中完成,比如背景透明度、文字、图标,避免各处硬编码

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2283

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4923

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6030

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5518

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

783

5

vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

1634

5

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

11882

5

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

2026.02.10

296

23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 16.9万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 2.5万人学习