NProgress 是 YouTube/Google 風格的極細頂部進度條,零依賴(需 jQuery 1.8+),適合 SPA、Pjax、傳統多頁應用的載入指示。
<!-- CDN -->
<link rel="stylesheet" href="https://unpkg.com/nprogress@0.2.0/nprogress.css">
<script src="https://unpkg.com/nprogress@0.2.0/nprogress.js"></script>
<!-- 或 npm -->
npm install nprogress
| 方法 | 說明 |
|---|---|
NProgress.start() | 顯示進度條(設為 0% 並動畫到隨機 10-30%) |
NProgress.set(n) | 設定具體進度 (0.0 - 1.0) |
NProgress.inc() | 微量遞增(隨機小量) |
NProgress.done() | 完成:動畫到 100% 後淡出隱藏 |
NProgress.configure(opts) | 全域配置 |
$(document).ajaxStart(() => NProgress.start());
$(document).ajaxStop(() => NProgress.done());
$(document).ready(() => NProgress.start());
$(window).on('load', () => NProgress.done());
NProgress.configure({
minimum: 0.08, // 最小顯示進度(避免閃爍)
template: '<div class="bar" role="bar"><div class="peg"></div></div><div class="spinner"></div>',
easing: 'ease', // CSS easing
speed: 200, // 動畫速度 ms
trickle: true, // 自動遞增動畫
trickleRate: 0.02, // 遞增量
trickleSpeed: 800, // 遞增間隔 ms
showSpinner: true, // 顯示右側旋轉指示器
parent: 'body' // 掛載容器
});
/* 修改顏色 */
#nprogress .bar { background: #29d; }
#nprogress .peg { box-shadow: 0 0 10px #29d, 0 0 5px #29d; }
#nprogress .spinner-icon { border-top-color: #29d; border-left-color: #29d; }
NProgress 體積極小(~2KB gzipped),API 簡潔,整合容易。現代專案亦可考慮 progress-bar.js、pace.js 或自製 CSS 動畫進度條以移除 jQuery 依賴。