YprogressBar 是一款基於 HTML5 的輕量級進度條外掛。體積小、佔用資源少、接入方式單純,視覺上模仿了常見的解壓縮視窗,除了百分比數字之外,還能在描述文字裡插入變數,即時呈現「上傳速度」「剩餘時間」這類更細節的執行資訊。程式碼結構寫得乾淨,掛進既有專案不會造成負擔。

只需要載入 yprogressbar.css 與 yprogressbar.js 兩個檔案即可。
var ypb = new YprogressBar({
title: "正在上傳檔案...",
des: "上傳速度:{{y:speed}}MB/秒 剩餘時間約 {{y:second}} 秒",
closeable: true,
cancelCallback: function (rate, vars) {
console.log(rate);
console.log(vars);
}
});
ypb.show();
整個設定就是一個物件,各欄位意義如下。
title:進度條標題,用一句話說明這個進度條在做什麼事。
des:更詳細的描述文字。若需要顯示動態資訊,直接在字串中寫入 {{y:名稱}} 格式的變數即可,例如 {{y:speed}} 與 {{y:second}}。一旦宣告了變數,後續呼叫 update() 時就必須一併把值補上。
closeable:是否顯示關閉按鈕;而 cancelCallback 是銷毀時的回呼。無論是主動呼叫 destroy(),還是使用者按下關閉鈕,都會觸發這個回呼,並帶入兩個參數——目前的執行進度,以及此刻描述文字中的變數值(物件形式,含 name 與 value)。
show():不需要參數,呼叫後進度條才會真正顯示出來。
update(rate, vars):更新進度。第一個參數是純數字的百分比,例如 26 代表 26%;第二個參數是物件,需包含描述中所有變數的值,若描述沒有變數則可省略。
ypb.update(26, { speed: 312, second: 5 });
destroy():銷毀進度條並釋放記憶體,同時觸發上面的銷毀回呼。
原始碼已放在 GitHub 上,需要的話可以直接取用或依自己的設計稿調整樣式。