瀏覽器原生的 alert 與 confirm 有兩個難以忍受的限制:樣式無法客製,且在部分情境下會被瀏覽器主動封鎖。以下實作一個通用的模態視窗元件,支援自訂標題、內容、按鈕與回調,並附遮罩層。
construct(){
setting = {
ID: 'window ID',
TitleText: '',
Content: 'content Text',
Parent: null, // 視窗的父元素,預設掛到 body
boxCss: 'class03_tank ',
TitleCss: 'class03_tank_top', // 標題 CSS
ContentCss: 'padtb10', // 內容 CSS
width: 280,
height: 'auto',
button: 'submit,cancel', // 按鈕類型
submitcall: null, // 點擊確定的回調
cancelcall: null // 點擊取消的回調
}
function _createWindow(opt){
var windowID = opt.ID, top, left;
if (windowID == null) return null;
if ($('#' + opt.ID).length > 0) $('#' + opt.ID).remove();
if (!opt.left) opt.left = ($(window).width() - opt.width) / 2;
if (!opt.top) opt.top = ($(window).height()) / 3 + $(document).scrollTop();
var parent = (opt.Parent == null || opt.parent.length == 0) ? $('body') : $(opt.Parent);
var box = $('<div>').attr('id', windowID).addClass(opt.boxCss)
.width(opt.width).height(opt.height)
.css({'left': opt.left, 'top': opt.top, 'z-index': 1111, 'position': 'absolute'});
parent.append(box);
return $('#' + opt.ID);
}
function _setWindowConstruct(w, opt){ // 建立視窗內部結構
w.subobj = w.obj;
// 標題列
w.subobj.append($('<div>').addClass('class03_tank_top').append(
$('<div>').addClass('class03_tank_topc').append(
w.close = $('<a>').attr('title','關閉').addClass('btnax fr bgcfff mart04').html('×')
).append(
$('<span>').addClass('disin_bl lineh30 marl10').html(opt.TitleText)
)
))
// 內容區
w.subobj.append(
$('<div>').addClass('class03_tank_con bgcfff').css({'text-align':'center'}).append(
$('<div>').attr('id','content_ui_' + opt.ID).addClass(opt.ContentCss)
)
);
// 底部裝飾
w.subobj.append('<div style="margin-top:0;"><b class="yz_b01"></b><b class="yz_b02"></b><b class="yz_b03 yz_b00"></b></div>');
return w;
}
function _setWindowSubmitButton(w, opt){ // 設定按鈕
var p = $('<p>').addClass('class03_tank_p');
var submit = $('<a>'), cancel = $('<a>');
btn = opt.button.split(',');
if (ST.Base.inArray(btn, 'submit') > -1){
p.append(submit.addClass('btnqx01').html('確定').bind('click', function(){
if ((opt.submitcall && opt.submitcall() !== false) || opt.submitcall == null){
$('#' + opt.ID).remove();
$('#MW_BACKOVER').hide();
}
if (ST.UI.timeId != null) window.clearTimeout(ST.UI.timeId);
}))
}
if (ST.Base.inArray(btn, 'cancel') > -1){
p.append(cancel.addClass('btnqx01 marlr06').html('關閉').bind('click', function(){
if ((opt.cancelcall && opt.cancelcall() !== false) || opt.cancelcall == null){
$('#' + opt.ID).remove();
$('#MW_BACKOVER').hide();
}
if (ST.UI.timeId != null) window.clearTimeout(ST.UI.timeId);
}))
}
w.close.bind('click', function(){
$('#' + opt.ID).remove();
$('#MW_BACKOVER').hide();
})
w.obj.children('.class03_tank_con').append(p);
}
function _setBackover(w){ // 建立遮罩層
if ($('#MW_BACKOVER').length > 0){ $('#MW_BACKOVER').show(); return; }
$("body").append(
$("<div>").attr("id", "MW_BACKOVER").css({
"background-color": "#ddd", "position": "fixed",
"top": "0", "left": "0", "width": "100%", "height": "100%",
"display": "block", "opacity": 0.5, 'z-index': 10
})
);
}
return function(opt){
opt = ST.extend(setting, opt);
var w = _createWindow(opt); // 建立視窗外殼
if (!w) return false;
windowObj = {'obj': w, 'subobj': null};
windowObj = _setWindowConstruct(windowObj, opt);
_setBackover(windowObj, opt);
_setWindowSubmitButton(windowObj, opt);
return {
getObject: function(){ return windowObj; },
close: function(){
$(windowObj['obj']).remove();
$('#MW_BACKOVER').hide();
return this;
},
setContent: function(content){
$('#content_ui_' + opt.ID).html(content);
return this;
},
load: function(url, callback){
$('#content_ui_' + opt.ID).load(url + '&r=' + Math.random(), callback);
return this;
}
}
}
}
靜態視窗沒有標題列,位置可指定或依觸發元素定位,適合做 tooltip 式的提示:
StaticWindow: (function(){
var Controller = null;
function _construct(opt){
setting = {
ID: '', left: 0, top: 0, width: 200, height: 100,
css: 'bgcfff', parent: '',
buttonCss: 'class03_tank_p', buttonCssRep: null,
button: 'sure,cancle', buttonText: null, layer: null
}
function _createWindow(opt){
if ($('#' + opt.ID).length > 0) $('#' + opt.ID).remove();
if (opt.layer != null){
opt.left = opt.layer.pageX;
opt.top = opt.layer.pageY + $(opt.layer.target).height();
}
var box = $('<div>').addClass(opt.css).css({
'position':'absolute', 'height':opt.height, 'width':opt.width,
'border':'1px solid #ccc', 'z-index':100, 'left':opt.left, 'top':opt.top
}).attr('id', opt.ID);
var parent = opt.parent != '' ? $(opt.parent) : $('body');
parent.append(box);
return $('#' + opt.ID);
};
function _setWindowConstruct(obj, opt){
obj.html('');
obj.append($('<div>').attr('id','static_content_' + opt.ID));
}
function _setButton(obj, opt){
btn = opt.button.split(',');
p = $('<p>').addClass(opt.buttonCss).css({'position':'absolute','bottom':0,'width':(opt.width-13)});
if (opt.buttonCssRep != null) p.css(opt.buttonCssRep);
if (ST.Base.inArray(btn,'sure') > -1){
var sure = $('<a>').addClass('btnqx01').html('確認').click(function(e){
if ((opt.surebtn && opt.surebtn(e) !== false) || opt.surebtn == null) obj.remove();
})
p.append(sure);
}
if (ST.Base.inArray(btn,'cancle') > -1){
cancel = $('<a>').addClass('btnqx01 marlr06').html('取消').click(function(e){
if ((opt.cancelbtn && opt.cancelbtn(e) !== false) || opt.cancelbtn == null) obj.remove();
})
p.append(cancel);
}
if (opt.buttonText != null) p.append(opt.buttonText);
obj.append(p);
}
return function(opt){
opt = ST.extend(setting, opt);
var w = _createWindow(opt);
if (!w) return false;
_setWindowConstruct(w, opt);
_setButton(w, opt);
return {
close: function(){ w.remove() },
setContent: function(content){ $('#static_content_' + opt.ID).html(content) },
append: function(obj){ $('#static_content_' + opt.ID).append(obj) },
load: function(url, callback){ $('#static_content_' + opt.ID).load(url, callback) }
}
}
}
return function(option){ Controller = _construct(); return Controller(option); }
})()
var w = ST.UI.ModeWindow({
'ID': '窗口ID',
'TitleText': '標題',
'submitcall': function(){ /* 確認按鈕執行的方法 */ },
'cancelcall': function(){ /* 取消按鈕執行的方法 */ },
'width': '寬',
'height': '高',
'boxCss': '視窗樣式',
'TitleCss': '標題樣式',
'ContentCss': '內容樣式',
'button': 'submit,cancel' // 預設兩個按鈕,也可只設其中一個
});
參數全部可選。w 即視窗物件,可用下列方法操作:
w.close(); // 關閉視窗
w.setContent('內容'); // 設定內容
w.getObject(); // 取得視窗物件
w.load('載入連結', '回調函式'); // 載入一個 url
靜態對話框的用法與模態對話框相同。
這個元件有幾個不錯的思路。_setBackover 會先檢查遮罩層是否已存在,有的話就 show 而非重建,避免重複節點堆積。ST.extend(setting, opt) 把預設值與傳入值合併,讓所有參數都可選。回調的判斷寫成 opt.submitcall() !== false,意味著回調若明確回傳 false 就不關閉視窗,這讓「驗證未通過時留在原地」的行為得以實作,是個很實用的約定。
但這份程式碼有幾處值得修正。setting 在函式內被赋值時前面沒有 var,會成為全域變數;windowObj、btn、cancel 同樣如此。多個視窗同時存在時,這些共用變數會互相干擾。load 方法在網址後附加 Math.random() 來避免快取,但也讓後端無法利用快取,建議改為明確的 cache 參數控制。另外 opt.Parent 與 opt.parent 大小寫不一致,會導致判斷失靈。
最後要提醒的是,這個元件用 .html(content) 寫入內容,若 content 可能來自使用者輸入,會形成 XSS 風險。另外它沒有做焦點管理與 ARIA 屬性,鍵盤使用者與螢幕閱讀器使用者無法正常操作。在今日的專案中,<dialog> 元素已內建了 these 能力——包含焦點鎖定、ESC 關閉、backdrop 樣式與適當的無障礙語意,除非需要高度客製,否則是更好的選擇。