Ajax 向後端取資料時,使用者往往不知道背後正在發生什麼事。這時給一個明確的「處理中」提示就顯得必要——也就是我們熟悉的 Loading 遮罩。
jQuery 可以對 Ajax 做全域設定,效果近似 C# 中的「面向切面」:在每次請求送出之前與結束之後,都能插入一段共同處理。於是我們在請求開始時顯示 Loading 框,請求結束時關掉它,效果就出來了。
$.ajaxSetup({
beforeSend: function () {
// Ajax 請求之前
},
complete: function () {
// 請求完成,不論成功或失敗都會執行
},
error: function () {
// 請求失敗
}
});
這些設定在單一請求中也可以各自指定,但只要寫進 ajaxSetup 並放進共用的頁面,它就成為全域預設值了。
如果同時存在多個 Ajax,很可能一個結束就把遮罩全關掉,其他還在跑的請求就少了提示。這裡有兩種思路。
做法一:每個請求各自擁有一個遮罩。座標重疊所以看不出差別,誰結束就關誰。要特別注意的是,index 這類自訂屬性必須寫進傳給 ajaxSetup 的設定物件裡,否則仍會被所有請求共用:
$(function () {
$.ajaxSetup({
layerIndex: -1,
beforeSend: function () {
this.layerIndex = layer.load(0, { shade: [0.5, '#393D49'] });
},
complete: function () {
layer.close(this.layerIndex);
},
error: function () {
layer.alert('部分資料載入失敗,可能導致頁面顯示異常,請重新整理後再試',
{ skin: 'layui-layer-molv', closeBtn: 0, shift: 4 });
}
});
});
這裡借用了 layer 這個元件來呈現 Loading,省下手寫 CSS 的功夫(官網:https://layer.layui.com/)。有能力的人也可以自行撰寫遮罩,用 JavaScript 控制顯示與隱藏。
做法二:只顯示一個遮罩,用計數器管理。在遮罩元素上放一個計數屬性,例如 <div data-ajax-count="0"></div>,每次請求開始時遞增、結束時遞減,並在遞減後判斷:若計數已小於或等於 0,才把遮罩隱藏。這個方式較為乾淨,但需要自行維護計數邏輯,本文未實際驗證。
兩種做法的取捨在於:前者實作簡單但會產生多個遮罩實例,後者結構清爽但要多寫幾行程式。