效果體驗:https://hovertree.com/texiao/jquery/10.htm
前面幾篇的遮罩層都是直接寫函式,這次改用外掛形式封裝,呼叫方式變成 $(...).mask() 與 $(...).unmask(),可讀性與重複使用性都更好,還能指定遮罩範圍是整個頁面或某個區塊。
(function(){
$.extend($.fn, {
mask: function(msg, maskDivClass){
this.unmask(); // 先清掉舊的遮罩,避免重複堆疊
var op = { opacity: 0.8, z: 10000, bgcolor: '#ccc' };
var original = $(document.body);
var position = { top: 0, left: 0 };
if (this[0] && this[0] !== window.document) {
original = this;
position = original.position();
}
var maskDiv = $('<div class="maskdivgen"> </div>');
maskDiv.appendTo(original);
var maskWidth = original.outerWidth() || original.width();
var maskHeight = original.outerHeight() || original.height();
maskDiv.css({
position: 'absolute',
top: position.top, left: position.left,
'z-index': op.z,
width: maskWidth, height: maskHeight,
'background-color': op.bgcolor,
opacity: 0
});
if (maskDivClass) { maskDiv.addClass(maskDivClass); }
if (msg) {
var msgDiv = $('<div><div>' + msg + '</div></div>');
msgDiv.appendTo(maskDiv);
msgDiv.css({
cursor:'wait',
top: (maskDiv.height() - msgDiv.height()) / 2 - 2,
left: (maskDiv.width() - msgDiv.width()) / 2 - 2
});
}
maskDiv.fadeIn('fast', function(){ $(this).fadeTo('slow', op.opacity); });
return maskDiv;
},
unmask: function(){
var original = $(document.body);
if (this[0] && this[0] !== window.document) { original = $(this[0]); }
original.find("> div.maskdivgen").fadeOut('slow', 0, function(){ $(this).remove(); });
}
});
})();
遮罩範圍的判斷:用 this[0] !== window.document 判斷呼叫者是整個文件還是某個元素。若是元素,就用它的 position() 與寬高做遮罩,且定位方式選 absolute 而非 fixed——因為要對齊的是元素而非視窗。
寬高的取值順序:outerWidth() 含 padding 與 border,若取到 0 再退回 width(),可避免隱藏元素算出 0 的問題。
提示訊息置中:用遮罩與訊息框的寬高差除以二,讓文字方塊精準落在中央;cursor:wait 則暗示目前處理中。
淡入效果:先 fadeIn('fast') 讓它出現,再 fadeTo('slow', 0.8) 漸變到目標透明度,比直接設定 opacity 柔和。
<a href="#" onclick="$('#testhovertree').mask('DIV層遮罩何問起')">div遮罩</a>
<a href="#" onclick="$('#testhovertree').unmask()">關閉div遮罩</a>
<a href="#" onclick="$(document).mask('全屏遮罩何問起').click(function () { $(document).unmask() })">全部遮罩</a>
同一個外掛,傳入元素就是局部遮罩,傳入 document 就是全螢幕遮罩,這正是外掛化最大的價值。