原理說穿了很樸素:用 JS 動態建一個 div 塞進 body,透過 position:absolute 或 fixed 讓它脫離文件流,再修修樣式就成了。真正花時間的是拖曳、置中、多層疊放這些細節。
<!-- 背景遮蓋層 -->
<div class="dialog-overlay"></div>
<!-- 對話框 -->
<div class="dialog">
<div class="bar">
<span class="title">標題</span>
<a class="close">[關閉]</a>
</div>
<div class="content">內容部分</div>
</div>
遮蓋層只在需要時才建立。每個 div 都掛一個 CSS 類,方便使用者自訂外觀。
思路是:在 mousemove 中算出兩次滑鼠位置的差值,加到框體原本的 top/left 上。由於 mousemove 只該在按住標題欄時生效,因此只在標題欄觸發 mousedown 時綁定,滑鼠放開時解除。
var mouse = { x: 0, y: 0 };
function moveDialog(event) {
var e = window.event || event;
var top = parseInt(dialog.css('top')) + (e.clientY - mouse.y);
var left = parseInt(dialog.css('left')) + (e.clientX - mouse.x);
dialog.css({ top: top, left: left });
mouse.x = e.clientX;
mouse.y = e.clientY;
}
dialog.find('.bar').mousedown(function (event) {
var e = window.event || event;
mouse.x = e.clientX;
mouse.y = e.clientY;
$(document).bind('mousemove', moveDialog);
});
$(document).mouseup(function (event) {
$(document).unbind('mousemove', moveDialog);
});
為什麼綁在 document 而不是標題欄?因為滑鼠移動過快時會衝出標題欄範圍,此時綁在標題欄上的事件就失效了;綁到 document 則不受影響。這是很典型的「事件捕獲範圍」思維。
IE 的 clientWidth、offsetWidth 等屬性與其他瀏覽器存在差異,直接改用 jQuery 的 width() 最省事:
var left = ($(window).width() - dialog.width()) / 2;
var top = ($(window).height() - dialog.height()) / 2;
dialog.css({ top: top, left: left });
用 scroll 事件模擬:
// top 表示對話框到可視區域頂部的距離
var top = parseInt(dialog.css('top')) - $(document).scrollTop();
var left = parseInt(dialog.css('left')) - $(document).scrollLeft();
$(window).scroll(function () {
dialog.css({
'top': $(document).scrollTop() + top,
'left': $(document).scrollLeft() + left
});
});
為了支援多個對話框並存,維護一個靜態的 zIndex 變數,每次建立新對話框就自增並賦值,保證最後建立的永遠在最上層。
var dlg = new Dialog(content, options);
dlg.show();
日常使用可以更省事:
new Dialog(content, options).show();
// 或
dialog(content, options);
show():顯示對話框。hide():隱藏,但不刪除內容。close():關閉並徹底清除內容。setContent(content):替換對話框內容。content 可以是字串,也可以是物件;為物件時需包含 type 與 value:
id:顯示某元素 id 內的內容(不含該元素本身),value 為元素 id。img:顯示圖片,value 為圖片 URI。url:以 AJAX 載入某網址內容,需同域,value 為 URL。iframe:以 iframe 顯示網址內容,可繞過 AJAX 的同域與 HTML 結構限制。title:標題欄文字,預設「標題」。closeText:關閉按鈕文字,預設「[關閉]」。showTitle:是否顯示標題欄(為否則標題與關閉鈕都不顯示),預設 true。draggable:是否可拖曳,預設 true。modal:是否為模態(不可操作背景層),預設 true。center:是否置中,預設 true。fixed:是否隨滾動條移動,預設 true。time:自動關閉時間(毫秒),0 表示不自動關閉。id:對話框 id,false 表示自動產生。beforeShow / afterShowbeforeHide / afterHidebeforeClose / afterClose四個 before 型回調若回傳 false,即可取消對應動作,這是攔截關閉、做「內容未儲存」提示的標準做法。
外掛為每個部件都預留了類名:.dialog-overlay(遮蓋層)、.dialog(本體)、.dialog .bar(標題欄)、.dialog .bar .title、.dialog .bar .close、.dialog .content。直接改類名可全域生效,也可以用 id 限定單一實例:
/* 只修改 id 為 dialog1 的對話框 */
#dialog1 .bar {
text-transform: lowercase;
}
// 透過 id 屬性指定對話框的 id
new Dialog('text', { id: 'dialog1' });