需求是這樣的:頁面上有多個 Ajax 請求,但我只希望在「某些特定請求」進行時顯示轉圈圈動畫,其他背景請求則保持安靜。直接改寫 $.ajax 的成本太高,容易破壞既有邏輯;其實借用 jQuery 自帶的 Ajax Events 就能優雅解決。
Ajax 觸發的全域事件會像標準事件一樣在 DOM 樹上傳播,事件層級大致是:jQuery Events > Ajax Events > 自訂的 Ajax 事件。既然事件會冒泡,我們就能透過「事件命名空間」判斷來源。
先建立一個命名空間 Wo,把 loading 元件與事件綁定集中管理:
Wo = window.Wo || {};
Wo.ajax = {
spinner : $([])
, init : function() {
var $spinner = this.spinner = $('#ajax-loading');
var show = function(e) {
if (e.namespace === 'Wo') $spinner.show();
};
var hide = function(e) {
$spinner.hide();
};
$spinner.bind({
'ajaxStart.Wo' : show
, 'ajaxStop.Wo' : hide
, 'ajaxError.Wo' : hide
});
this.adapt(['getJSON','get','post','ajax']);
}
// 準備送出請求
, _prepare : function() {
this.spinner.trigger('ajaxStart.Wo');
}
// 介面批量替換
, adapt : function(fns) {
var self = this;
$.each(fns, function(i, fn) {
Wo[fn] = function() {
self._prepare();
$[fn].apply(this, arguments);
}
});
}
};
有兩種方式可以辨識「這個事件是不是我關心的那一個」:一是使用確定的命名空間,二是在觸發時額外傳入參數給事件處理函式。這裡採用命名空間的做法,因為它最乾淨,也不干擾既有呼叫。
adapt 的設計其實就是「轉接器模式」的應用:用一套包裝過的介面,取代原本 jQuery 的 getJSON、get、post、ajax,讓這些方法在執行前先觸發自訂的 ajaxStart.Wo。
load 稍微麻煩,因為它既可能是 Ajax 請求,也可能是元素的 onload 事件,需要先做型別判斷再決定要不要觸發提示:
var _load = $.fn.load;
$.fn.load = function() {
$.type(arguments[0]) === 'string' && self._prepare();
_load.apply(this, arguments);
return this;
};
只有第一個參數是字串(代表要載入某個 URL)時才觸發提示,避免元素載入事件誤觸。
參數形式與原生方法一致,既有程式碼不必改寫:
Wo.post(url, [data,] callback)
整體的好處是:loading 的顯示邏輯被收攏在一個地方,個別請求不需要各自處理,也不必為了加一個動畫而全面重寫 Ajax 層。