無論伺服器回應多快,Client 與 Server 的一來一回總會有等待載入資料的時間。多數網站會用一個 Gif 動態圖示或「Loading...」字樣告知使用者資料仍在載入。但有時這件事相當麻煩:要嘛在每次 ajax 請求前顯示、成功後隱藏,要嘛寫進全域事件 jQuery.ajaxStart() 與 jQuery.ajaxStop() 控制整個頁面的狀態。前者過於瑣碎,後者又是全域的,難以滿足局部顯示的需求。
為了解決這些問題,我開發了一個名為「Ajax 請求狀態管理器」的外掛,讓 loading 不再麻煩。你可以在觸發請求前先註冊好所有請求,使用時只需在互動事件中呼叫 .request(),並可選擇讓每個請求獨立顯示 loading,或全域只顯示一個。
自定義 loading 的 CSS 樣式:
.state-loading { background: #fff url(images/icon-ajax-loader.gif) ... }
引用 jQuery(此外掛在 1.4.4 及之後版本測試通過):
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1/jquery.js"></script>
引用外掛檔:
<script src="js/jquery-ajaxloader.js"></script>
在 ready 事件中執行 install():
$.loader.install( className, isGlobal );
參數:className 為自定義 loading 的 class 名稱;isGlobal 為布林值,定義是全域顯示(true,預設)還是獨立顯示 loading。
新增請求參數與成功回調:
$.loader( key ).add( modules, settings, callback );
key 用來建立或取得指定模組的載入器;modules 為要顯示 loading 的 jQuery 物件;settings 為 ajax 設定(勿設 ajax 事件以免覆蓋回調,預設 GET);callback 為成功後的回調,參數 data 預設為 json 物件。add() 會回傳如 ['module1','module2','module3'] 的陣列。
刪除指定模組:
$.loader( key ).remove( moduleId );
在互動事件中觸發請求:
$.loader( key ).request();
你也可以拋棄預先 add 的設定,自行寫 $.ajax 或 $.get,並在請求前呼叫 $.loader( key ).show()、在回調中呼叫 $.loader( key ).hide() 來靈活控制 loading 狀態。
注意:同一請求反覆觸發時,管理器會執行 abort() 阻止之前未完成的請求,再發新請求。若你在頁面用 ajaxError 事件輸出錯誤資訊,需自行過濾掉 abort 的情況(status 為 0、readyState 為 0 或 statusText 為 'abort')。
打包下載:Ajax 請求狀態管理器。