ithub Star: 26k[1] 官网[2]
NProgress.js 是一个轻量级的 JavaScript 库,用于在应用的页面顶部显示一个进度条,指示页面加载或异步操作的进度。它非常适合用于单页面应用程序(SPA),能够在路由变化时给用户友好的加载提示。本文是 NProgress.js 的基本使用方法和一些配置选项的详细介绍。
安装和引入
NProgress.js 支持管理工具 npm 或 yarn 安装,也支持 CDN 引入。
npm install nprogress -S
#
yarn add nprogress
引入时,别忘了引入 nprogress.css 样式文件
启动和结束进度条
NProgress.start(); // 启动进度条
NProgress.done(); // 结束进度条
设置进度
NProgress.set(0.4); // 设置进度至 40%
设置进度百分比,参数取值 0 ~ 1 之间。如果传 0 类似于调用 .start(),传 1 类似于调用 .done() 方法。
递增进度条
NProgress.inc(); // 随机递增进度条
NProgress.inc(0.2); // 以 0.2 的值递增进度条
递增进度条,以随机量增加,永远不会到达 100%。
NProgress.configure({
easing: 'ease', // 动画方式
speed: 500, // 递增进度条的速度
showSpinner: false, // 是否显示加载指示器
trickle: false, // 是否开启自动递增行为
trickleSpeed: 200, // 自动递增间隔
minimum: 0.3, // 更改启动时使用的最小百分比
parent: 'body', // 指定进度条的父容器
barSelector: '[role="bar"]', // 进度条选择器
spinnerSelector: '[role="spinner"]' // 加载指示器选择器
});
配置项还有 template 自定义模板,为了保证正常工作,需要保留一个带 role='bar' 的元素。参考默认模板。
NProgress.configure({
template: `
<div class="bar" role="bar">
<div class="peg"></div>
</div>
<div class="spinner" role="spinner">
<div class="spinner-icon"></div>
</div>`
})
另外,通过覆盖 nprogress.css 样式,可以实现定制化样式。
在 Vue 项目中,可以将 NProgress.js 集成到路由系统中,方便页面跳转时显示进度条。在 router/index.js 中引入 NProgress 并在路由卫士中调用相应的 API。
import NProgress from 'nprogress'
import 'nprogress/nprogress.css'
// 导入进度条
import { start, close } from '../utils/nprogress';
const router=new VueRouter({
// ...
});
router.beforeEach((to, from, next)=> {
NProgress.start();
next();
});
router.afterEach(()=> {
NProgress.done();
});
修改进度条样式
通过添加 CSS 样式来自定义进度条的颜色和其他视觉效果。
#nprogress .bar {
background: green !important; /* 自定义颜色 */
}
NProgress.js 使用一种简单的方式来改善用户体验,在单页应用中,通过在页面跳转期间显示进度条,可以让用户知道页面正在加载,从而减少用户的等待焦虑感。通过本文相信你已经能够在项目中轻松使用 NProgress.js 了。
祝好!
[1] Github Star: 26k: https://github.com/rstacruz/nprogress
[2] 官网: https://ricostacruz.com/nprogress/
版css是切版网目前内部使用的框架,甚至于不算是一个框架,它只是提供了一个可靠的基础去创建你一个前端项目,提供了一段来自经验的css重写,和一些经验之谈,并且约束了一些命名上的规范。
演示
http://www.qieban.cn/demo/
更新笔记
添加了使用比较频繁的js插件
jquery1.7.2压缩版本
jquery-1.7.2.min.js
写css3前缀太麻烦?
-webkit-
-o-
-moz-
一个prefixfree.min.js文件搞定
prefixfree.min.js
wow.js让静态页面动起来
wow.min.js
需要扩展jquery的动画轨迹?
jquery.easing.1.3.js
需要用到jquery的触摸时间swipe
jquery.mobile-1.0.1.min.js
想用比jquery更小的zepto?
zepto.min.js
让ie9以下的浏览器支持h5?
html5.js
fullpage滑屏效果经常用到的箭头效果
/*弹球(箭头)*/
调用
.qieban{animation: bounce-up 1.4s linear infinite; }
等等。后面工作中再有更多好用的代码将不定期更新。
来源:https://www.oschina.net/news/86445/qieban-1-2
<div class="numCount">
<span class="numCX" data-startVal="0" data-endVal="363567"
data-speed="4" data-decimals="0" id="mumC1">363567</span>
</div>
<script src="js/count.js"></script>
<script type="text/javascript">
$(function(){
var countCXArr=[];
var countCX=function (){
// ***外围盒子需要有numCount这个class,执行动画的子元素class为【numCX】,该元素必须有id**
$('.numCount').each(function(i, dom) {
if(countCXArr[i] && countCXArr[i]===true){
return;
}
var sT;
var ncTop;
sT=$(window).scrollTop();
ncTop=$(dom).offset().top;
var id,decimals, startVal, endVal, duration;
if (sT > ncTop-$(window).height() && sT < ncTop) {
$(dom).find('.numCX').each(function(){
id=$(this).attr('id');//id在这里运用
decimals=$(this).attr('data-decimals'),
startVal=$(this).attr('data-startVal'),
endVal=$(this).attr('data-endVal'),
duration=$(this).attr('data-speed');
new CountUp(id, startVal, endVal, decimals, duration, {
useEasing: true,//效果
separator: ''//数字分隔符
}).start();// target:目标元素id, startVal:你想要开始的值, endVal:你想要到达的值, decimals:小数位数,默认值为0, duration:动画持续时间为秒,默认值为2, options:选项的可选对象
countCXArr[i]=true;
})
}
})
}
countCX();
$(window).on("scroll",function() {
countCX();
})
});
</script>
*请认真填写需求信息,我们会在24小时内与您取得联系。