var maskStackCount = 0;
/**
* 頁面遮罩控制
* @param {'open'|'close'} method - 操作類型,預設 'open'
*/
function mask(method) {
method = method || 'open';
// 目標窗口:這裡針對 iframe,也可用 $(window) 或 $('body')
var winObj = window.top.$('body').find("iframe[name='dialognormaliframe']");
if (method === 'open') {
if (maskStackCount <= 0) {
// 建立遮罩元素
var $mask = $('')
.appendTo('body');
// 設定尺寸覆蓋目標窗口
$mask.css({
width: winObj.width() + 'px',
height: winObj.height() + 'px',
filter: 'alpha(opacity=60)', // IE8 相容
opacity: 0.6,
background: '#000',
position: 'absolute',
top: 0,
left: 0,
zIndex: 9999
}).show();
// 視窗縮放時自適應調整
winObj.on('resize.mask', function() {
$mask.css({
width: winObj.width() + 'px',
height: winObj.height() + 'px'
});
});
}
maskStackCount++;
}
else if (method === 'close') {
maskStackCount--;
if (maskStackCount <= 0) {
$('#window-mask').remove();
winObj.off('resize.mask');
maskStackCount = 0; // 保護歸零
}
}
}
.window-mask {
position: fixed; /* 相對 viewport 定位,不受滾動影響 */
top: 0; left: 0; right: 0; bottom: 0;
background: rgba(0, 0, 0, 0.5); /* 現代瀏覽器半透明 */
z-index: 9999;
display: none;
}
/* IE8 降級 */
.ie8 .window-mask {
background: #000;
filter: alpha(opacity=50);
}
// AJAX 請求前開啟,完成後關閉
function loadData() {
mask('open');
$.ajax({
url: '/api/data',
success: function(res) { render(res); },
complete: function() { mask('close'); }
});
}
// 巢狀調用:外層開啟,內層也開啟,只有外層關閉時才移除
function outer() {
mask('open');
inner();
mask('close');
}
function inner() {
mask('open');
// do something
mask('close');
}
function mask(method, options) {
options = $.extend({
message: '載入中...',
spinner: true
}, options);
if (method === 'open') {
if (maskStackCount <= 0) {
var $mask = $('').appendTo('body');
var $content = $('').appendTo($mask);
if (options.spinner) {
$content.append('');
}
$content.append('');
// 置中
$content.css({
position: 'absolute',
top: '50%', left: '50%',
transform: 'translate(-50%, -50%)',
color: '#fff', textAlign: 'center'
});
// ... 尺寸調整邏輯同前
}
maskStackCount++;
} else {
// ... 關閉邏輯同前
}
}
// 使用
mask('open', { message: '資料儲存中,請稍候...' });
winObj.width() 會報錯,需用 postMessage 通訊或改遮罩父頁面try/finally 確保關閉touch-action: none 或監聽 touchmove 阻止預設<div class="modal-overlay" id="overlay">
<div class="modal-content">...</div>
</div>
.modal-overlay {
position: fixed; inset: 0;
background: rgba(0,0,0,0.5);
display: flex; align-items: center; justify-content: center;
opacity: 0; visibility: hidden; transition: 0.3s;
z-index: 1000;
}
.modal-overlay.active { opacity: 1; visibility: visible; }
// JS 只需切換 class
$('#overlay').addClass('active'); // 開啟
$('#overlay').removeClass('active'); // 關閉
堆疊計數器模式解決多重遮罩管理問題,配合 resize 事件自適應、iframe 目標鎖定,構建健壯的遮罩工具函數。現代專案建議採用 CSS-driven 方案,JS 僅負責狀態切換,關注點分離更清晰。