遮罩層(mask)常用於「處理中請稍候」、強制使用者先關閉某個視窗等情境。以下實作不只做出半透明遮罩,還處理了視窗尺寸變動與多層堆疊兩個實務問題,使用前需先引入 jQuery。
var maskStackCount = 0;
function mask(method) {
// 這裡指定要被遮罩的視窗;本例遮的是一個 iframe,
// 若要遮整個視窗可改成 var winObj = $(window)
var winObj = window.top.$("body").find("iframe[name='dialognormaliframe']");
if (typeof method == "undefined") {
method = "open";
}
if (method == "open") {
if (maskStackCount <= 0) {
var mask = $("<div id='window-mask' class='window-mask'
style='display:none'></div>").appendTo("body");
mask.css({
width: winObj.width() + "px",
height: winObj.height() + "px",
filter: "alpha(opacity=60)" // 舊版 IE 專用
}).show();
winObj.on("resize.mask", function () {
mask.css({
width: winObj.width() + "px",
height: winObj.height() + "px"
});
});
}
maskStackCount++;
}
else if (method == "close") {
maskStackCount--;
$("#window-mask").remove();
winObj.off("resize.mask");
}
}
maskStackCount 記錄目前有幾個請求正在等待遮罩。只有從 0 變成 1 時才真正建立遮罩元素,後續請求只把計數加一。這樣可以避免「A 流程結束時把 B 流程還需要的遮罩一起關掉」的常見 bug。
遮罩建立時先量一次目標的尺寸,之後透過 resize.mask 事件持續同步寬高。事件名稱後面加上 .mask 這個命名空間,是為了能只解除自己綁定的那一個,不影響同一元素上的其他 resize 處理器。
遮罩要真正蓋住內容,樣式上還需要:
.window-mask {
position: absolute;
top: 0;
left: 0;
background-color: #000;
opacity: 0.6;
z-index: 9999;
}
filter: alpha(opacity=60) 是舊 IE 的寫法,現代瀏覽器直接用 opacity 即可。
open 之後發生例外導致沒走到 close,計數會永遠停在 1,遮罩再也關不掉。建議用 try/finally 或把遮罩生命週期綁到 ajax 的 complete 事件上。z-index 高於內容,使用者仍點得到背後的按鈕。<dialog> 搭配 ::backdrop 偽元素,或用 CSS backdrop-filter 做出毛玻璃效果,不必自己刻遮罩層。