[Vue 配置] Vite + Vue3 项目配置和使用 NProgress

文章归档:https://www.yuque.com/u27599042/coding_star/mfmsrf9tz98ox3qg

安装

bash 复制代码
pnpm i nprogress

配置 NProgress

其他更多可参考,仓库地址:https://github.com/rstacruz/nprogress

在 src/config/nprogress.js 中进行配置

是否展示右上角圆圈加载动画

javascript 复制代码
NProgress.configure({ 
  showSpinner: false
});

设置样式

src/styles/nprogress.css

css 复制代码
#nprogress .bar {
    /* 自定义进度条颜色 */
    background: #fa2c19 !important;
}

#nprogress .peg {
    /* 自定义进度条阴影颜色 */
    box-shadow: 0 0 10px #fa2c19, 0 0 5px #fa2c19 !important;
}

启动时进度的最小百分比

默认 0.08

javascript 复制代码
NProgress.configure({ 
  minimum: 0.1
});

进度条动画和速度

动画可选值:

  • linear:动画从开始到结束保持相同的速度。
  • ease:默认值,动画有一个缓慢的开始,然后加速,在结束之前又变慢。
  • ease-in:动画有一个缓慢的开始。
  • ease-out:动画有一个缓慢的结束。
  • ease-in-out:动画有一个缓慢的开始和一个缓慢的结束。
  • cubic-bezier(n,n,n,n):在三次贝塞尔(cubic-bezier)函数中定义自己的值。可以是从 0 到 1 之间的数字值。
javascript 复制代码
NProgress.configure({ 
  easing: 'ease', 
  speed: 500
});

关闭自动递增

默认 true

javascript 复制代码
NProgress.configure({ 
  trickle: false
});

进度条递增速度

单位毫秒,多久自动递增一次

javascript 复制代码
NProgress.configure({ 
  trickleSpeed: 200
});

指定父容器

默认 body

javascript 复制代码
NProgress.configure({ 
  parent: '#container'
});

引入

在 main.js 中引入 nprogress 配置和样式

javascript 复制代码
import "nprogress/nprogress.css" // nprogress 样式
import "@/styles/nprogress.css" // 自定义修改 nprogress 
import '@/config/nprogress.js' // nprogress 配置

使用

javascript 复制代码
// 在需要使用的地方导入
import NProgress from 'nprogress'

// 开启进度条
NProgress.start()

// 结束进度条
NProgress.done()

// 设置进度条百分比,n 取值 0 - 1
NProgress.set(n)

// 获取进度条状态
NProgress.status()

// 增加进度条进度,但不会到 100%,n 取值 0 - 1
NProgress.inc(n);

vue router 中使用

javascript 复制代码
// 全局前置守卫
router.beforeEach(async(to, from, next) => {
    // 开启进度条
    NProgress.start();
}

// 全局后置守卫
router.afterEach(() => {
    // 结束进度条
    NProgress.done();
});

axios 中使用

javascript 复制代码
//请求拦截器
instance.interceptors.request.use(
    (config) => {
        // 开启进度条
        NProgress.start();
		    //...
    },
    (error) =>{
        // 结束进度条
        NProgress.done();
		    //...
	}
);

//响应拦截器
instance.interceptors.response.use(
    (response) => {
        //响应成功
        // 结束进度条
        NProgress.done();
        //...
    },
    (error) => {
        // 结束进度条
        NProgress.done();
        //...
    }
);
相关推荐
然我6 分钟前
不用 Redux 也能全局状态管理?看我用 useReducer+Context 搞个 Todo 应用
前端·javascript·react.js
前端小巷子11 分钟前
Web 实时通信:从短轮询到 WebSocket
前端·javascript·面试
神仙别闹14 分钟前
基于C#+SQL Server实现(Web)学生选课管理系统
前端·数据库·c#
web前端神器20 分钟前
指定阿里镜像原理
前端
枷锁—sha25 分钟前
【DVWA系列】——CSRF——Medium详细教程
android·服务器·前端·web安全·网络安全·csrf
枷锁—sha27 分钟前
跨站请求伪造漏洞(CSRF)详解
运维·服务器·前端·web安全·网络安全·csrf
群联云防护小杜43 分钟前
深度隐匿源IP:高防+群联AI云防护防绕过实战
运维·服务器·前端·网络·人工智能·网络协议·tcp/ip
DanB241 小时前
html复习
javascript·microsoft·html
汉得数字平台1 小时前
【鲲苍提效】全面洞察用户体验,助力打造高性能前端应用
前端·前端监控
花海如潮淹1 小时前
前端性能追踪工具:用户体验的毫秒战争
前端·笔记·ux