整合营销服务商

电脑端+手机端+微信端=数据同步管理

免费咨询热线:

NProgress.js,一款神奇的 JavaScr

NProgress.js,一款神奇的 JavaScript 开源库-页面进度条


ithub Star: 26k[1] 官网[2]

NProgress 是什么?

NProgress.js 是一个轻量级的 JavaScript 库,用于在应用的页面顶部显示一个进度条,指示页面加载或异步操作的进度。它非常适合用于单页面应用程序(SPA),能够在路由变化时给用户友好的加载提示。本文是 NProgress.js 的基本使用方法和一些配置选项的详细介绍。

快速开始

安装和引入

NProgress.js 支持管理工具 npmyarn 安装,也支持 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 中使用

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

、Html

<div class="numCount">
  <span class="numCX" data-startVal="0" data-endVal="363567" 
  data-speed="4" data-decimals="0" id="mumC1">363567</span>
</div>

2、Js关键code

<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>

关于countjs插件