網站上常有需要提醒使用者注意某段訊息的場合,用瀏覽器原生的 alert 顯得突兀,又不好控制樣式。比較實用的做法是自己在頁面上做一個帶半透明遮罩的彈出層:彈出時鎖住背景、讓視線聚焦在提示框上,幾秒後自動收起,也可以手動關閉。
下面這份程式碼把彈窗的樣式、結構與腳本集中管理,哪裡需要就直接呼叫,共有幾個能力:鎖定背景滾動、點擊右上角關閉、兩秒後自動關閉,以及透過參數切換提示圖示。
<style>
#H-dialog{display:none;position:absolute;z-index:9999999;width:400px;height:auto;background-color:#fff;}
#H-dialog .close{float:right;font-size:30px;margin-right:10px;margin-top:5px;cursor:pointer;}
#H-dialog .title{height:40px;padding-left:10px;font-size:20px;line-height:40px;}
#H-dialog #msgCont{height:36px;margin:30px 0 50px;padding-left:65px;font-size:25px;
line-height:36px;vertical-align:middle;background:url(../Images/ui_alert.png) no-repeat 20px 50%;}
</style>
<div id="H-dialog">
<a class="close" onclick="popupClose(this)">×</a>
<div class="title">提示</div>
<div id="msgCont">內容</div>
</div>
預設狀態是 display:none,由腳本在需要的時候把它顯示出來。關閉按鈕放在標題列右側,點擊後呼叫 popupClose。
彈窗出現時,後面的內容應該「按暫停」。這裡的做法是動態建立一個鋪滿可視區域的深色層,透明度設為 0.4,層級壓在彈窗之下:
function lockScreen() {
var clientH = document.body.offsetHeight; // body 高度
var clientW = document.body.offsetWidth; // body 寬度
var docH = document.body.scrollHeight; // 文檔高度
var docW = document.body.scrollWidth; // 文檔寬度
var bgW = clientW > docW ? clientW : docW; // 取較大值作為遮罩寬
var bgH = clientH > docH ? clientH : docH; // 取較大值作為遮罩高
var blackBg = document.createElement("div");
blackBg.id = "blackBg";
blackBg.style.position = "absolute";
blackBg.style.zIndex = "99999";
blackBg.style.top = "0";
blackBg.style.left = "0";
blackBg.style.width = bgW + "px";
blackBg.style.height = bgH + "px";
blackBg.style.opacity = "0.4";
blackBg.style.backgroundColor = "#333";
document.body.appendChild(blackBg);
}
寬高取「視窗可見尺寸」與「文檔實際尺寸」中的較大值,是為了避免頁面出現橫向或縱向捲軸時遮罩蓋不滿。
// 手動關閉:移除遮罩並隱藏彈窗
function popupClose(el) {
var blackBg = document.getElementById("blackBg");
blackBg && document.body.removeChild(blackBg);
el.parentNode.style.display = "none";
}
// 自動關閉:兩秒後收好家伙
function autoClose(id) {
id = id || "H-dialog";
var blackBg = document.getElementById("blackBg");
var objDiv = document.getElementById(id);
setTimeout(function () {
blackBg && document.body.removeChild(blackBg);
objDiv.style.display = "none";
}, 2000);
}
核心函式接受四個參數:提示內容、狀態類型(0 為一般提示、1 為成功提示)、彈窗 id、內容區 id。後三個都有預設值,日常呼叫時只傳第一個參數即可:
function showMsg(msg) {
msg = msg || "請重新操作";
var status = arguments[1] || 0,
popupId = arguments[2] || "H-dialog",
contentId = arguments[3] || "msgCont";
lockScreen();
// 取得屏幕實際寬高,相容不同瀏覽器的 quirks mode
var pageWidth = window.innerWidth,
pageHeight = window.innerHeight;
if (typeof pageWidth != "number") {
if (document.compatMode == "CSS1Compat") {
pageWidth = document.documentElement.clientWidth;
pageHeight = document.documentElement.clientHeight;
} else {
pageWidth = document.body.clientWidth;
pageHeight = document.body.clientHeight;
}
}
// 取得捲動距離,讓彈窗在當前視線位置居中
var scrollLeft = document.documentElement.scrollLeft,
scrollTop = 0;
if (typeof window.pageYOffset != 'undefined') {
scrollTop = window.pageYOffset;
} else if (typeof document.compatMode != 'undefined' &&
document.compatMode != 'BackCompat') {
scrollTop = document.documentElement.scrollTop;
} else if (typeof document.body != 'undefined') {
scrollTop = document.body.scrollTop;
}
var div_X = (pageWidth - 400) / 2 + scrollLeft;
var div_Y = (pageHeight - 200) / 2 + scrollTop;
var objDiv = document.getElementById(popupId);
if (status) {
document.getElementById(contentId).style.background =
"url($Root/Assets/Images/ui_success.png) no-repeat 20px 50%";
}
document.getElementById(contentId).innerHTML = msg;
objDiv.style.display = "block";
objDiv.style.left = div_X + "px";
objDiv.style.top = div_Y + "px";
autoClose(popupId);
}
水平與垂直位置都是用「視窗尺寸減去彈窗尺寸再除以二」,再加上捲軸偏移量,如此一來即使使用者已經往下捲了半天,彈窗依然會出現在眼前而不是頁面頂端。
這份程式碼寫於 opacity 尚未標準化的年代,因此在舊版 IE 上還需要額外加上 filter: alpha(opacity=40) 才會生效;另外 position:absolute 搭配 JS 計算坐標的做法,在行動裝置或需要鎖定整個 viewport 的場景下,改用 position:fixed 會更省事。若想進一步處理 Tab 鍵焦點、Esc 關閉等細節,也可以考慮直接採用成熟的 dialog 元件。