萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

NProgress.js 輕量進度條完整指南:Ajax 整合、配置與無 TurboLinks 環境應用

前言

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

核心 API

方法說明
NProgress.start()顯示進度條(設為 0% 並動畫到隨機 10-30%)
NProgress.set(n)設定具體進度 (0.0 - 1.0)
NProgress.inc()微量遞增(隨機小量)
NProgress.done()完成:動畫到 100% 後淡出隱藏
NProgress.configure(opts)全域配置

Ajax 整合(jQuery)

$(document).ajaxStart(() => NProgress.start());
$(document).ajaxStop(() => NProgress.done());

無 TurboLinks/Pjax 環境:綁定頁面生命週期

$(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 依賴。

copyright © 萬盛學電腦網 all rights reserved