遮罩層是模態對話框的基礎建設:一個鋪滿整個視窗的半透明層,攔住背後的所有互動,讓使用者的注意力集中在彈出的內容上。這裡用單例的方式把它包成一個建構函式。
/*
* 模態遮罩層單例物件
* opacity: 背景透明度
* 1. show()
* 2. close()
*/
Q.Overlay = function(opacity) {
var self = this;
self._createDiv = function() {
if (self._overlay) return; // 已建立則不重複
self._overlay = $("<div></div>");
var overlayCss = {
'width': '100%',
'min-height': '100%',
'position': 'fixed',
'top': 0,
'left': 0,
'z-index': Q.Overlay.zindex,
'background': '#ccc',
'text-align': 'center',
'opacity': opacity
};
// 舊 IE 不認 fixed,改用 absolute 並手動撐滿整頁高度
if ($.browser.msie && $.browser.version.substr(0, 1) < 7) {
overlayCss.position = "absolute";
overlayCss.height = Q.dom.pageHeight();
}
self._overlay.css(overlayCss);
$(document.body).append(self._overlay);
};
self.show = function() {
self._createDiv();
Q.Overlay.zindex++;
self._overlay.show();
};
self.close = function() {
self._overlay.hide();
self._overlay.remove();
self._overlay = undefined;
};
};
Q.Overlay.zindex = 1000;
z-index 用靜態屬性遞增。Q.Overlay.zindex 從 1000 起算,每次 show 就加一,這樣多層遮罩堆疊時,後開的一定在上面,不必每個呼叫端自己算數字。
close 時真的 remove。不只是 hide,而是把節點從 DOM 摘掉並把參照設回 undefined。這樣下次 show 時 _createDiv 裡的 if 判斷才會重新走一次建立流程,透明度等參數也能跟著更新。
舊 IE 的 fixed 問題。IE6 不支援 position: fixed,因此改用 absolute 並搭配手動計算的整頁高度 Q.dom.pageHeight()。這段判斷用了 $.browser,該 API 已在 jQuery 1.9 移除,新專案請改用特色偵測。
遮罩層最實用的場合之一,是在 ajax 請求進行中阻擋使用者操作,避免他連點兩下滑出重複請求;請求失敗時再給一個明確提示。
/* 統一 ajax 錯誤處理 */
Q.initAjaxErrorHandler = function() {
var overlay = new Q.Overlay(0.0); // 完全透明,只攔互動不改觀感
$(document.body).ajaxStart(function() {
overlay.show();
});
$(document.body).ajaxSuccess(function() {
overlay.close();
});
$(document.body).ajaxError(function() {
Q.alert("請求出錯,請刷新頁面並稍候再試!");
});
};
這裡透明度刻意設為 0.0:使用者看不到任何視覺變化,但滑鼠點擊被吃掉了,正好達到「鎖住介面」的效果。若希望讓使用者明確感知到「系統忙碌中」,則可改為 0.3 左右,並在遮罩上放一張 loading 動畫。
ajaxError 的回呼裡只呼叫了 Q.alert,卻沒有關閉遮罩。實作時請確認錯誤路徑也會走到 close——否則遮罩會永遠留在畫面上,使用者只能重新整理。比較穩健的寫法是在 complete 而非 success 中收遮罩,因為 complete 無論成功失敗都會觸發。