jQuery UI 的 Dialog 元件是製作彈跳視窗的利器,但初學者往往被琳瑯滿目的屬性搞得眼花撩亂。本文把實務上最常碰到的屬性、事件與方法系統性地梳理一遍,讓你查閱時一目了然。
先從實際案例下手,認識最典型的用法:
$('#dialogDiv').dialog({
hide: true, // 點擊關閉時隱藏,若不加上此行,關閉後再開可能出錯
autoOpen: false,
height: 380,
width: 800,
modal: true, // 開啟蒙層,會遮罩並影響頁面操作
title: '開標人',
overlay: { opacity: 0.5, background: "black", overflow: 'auto' },
buttons: {
'確定': function(){ /* 處理方法 addUser(); */ },
'取消': function(){ $(this).dialog("close"); }
}
});
$('#addItems').click(function(){
loadPage('buildOpeningGroupAddOpering.htm', '#dialogDiv');
$('#dialogDiv').data('title.dialog', '新增開標人').dialog('open'); // 動態修改標題
return false;
});
搭配一個能載入外部頁面的辅助函式,並在載入前清掉不需要的 html、body、link 等標籤:
function loadPage(path, id) {
$.get(path, function(data) {
data = data.replace(/<\/?link.*>/ig,"");
data = data.replace(/<\/?html.*>/ig,"");
data = data.replace(/<\/?body.*>/ig,"");
data = data.replace(/<\/?head.*>/ig,"");
data = data.replace(/<\/?!doctype.*>/ig,"");
data = data.replace(/<title.*>.*<\/title>/ig,"");
$(id).empty().html(data);
});
}
如果想讓彈窗能拖曳、能縮放,記得另外引入 ui.draggable.js 與 ui.resizable.js。最精簡的啟動寫法如下:
$("#dialog").dialog({
autoOpen: false,
buttons: { "確定": function(){ $(this).dialog("close"); } },
closeOnEscape: true,
hide: "slide",
modal: true,
title: "對話框"
}).dialog("open");
autoOpen:設為 true 時建立即自動彈出,設為 false 則需呼叫 .dialog("open") 才顯示,預設 true。
bgiframe:預設 false。開啟後會啟用 bgiframe 外掛,用來解決 IE6 的下拉選單蓋在遮罩之上的老問題。
buttons:定義視窗按鈕及其點擊回呼,預設為空物件。
closeOnEscape:是否允許按 ESC 關閉視窗,預設 true。
dialogClass:為視窗額外加上自訂 class,方便客製樣式。
draggable / resizable:分別控制能否拖曳標題移動、能否縮放視窗,預設皆為 true。
width / height:視窗寬高,預設 auto 自動。
maxWidth / maxHeight / minWidth / minHeight:縮放的最大最小限制,寬高的最大預設 false(不限),最小預設 150,需 resizable 支援。
hide / show:關閉與開啟時的動畫效果,預設 null 無效果。
modal:是否為模式視窗,開啟後頁面其他元素無法點擊,預設 false。
title:視窗標題文字。
position:顯示位置,可用 'center'、'left'、'right'、'top'、'bottom',也可用偏移量或字串陣列如 ['right','top']。
zIndex:層級值,預設 1000。
stack:預設 true,取得焦點時視窗會浮到最上層。
Dialog 提供了 beforeclose(關閉前觸發,回傳 false 可阻止關閉)、close(關閉後觸發)、open(開啟時觸發)與 focus(取得焦點時觸發)等事件。此外拖曳與縮放過程中也有 dragStart、drag、dragStop、resizeStart、resize、resizeStop 等事件可供響應。
除了開關用的 open 與 close,還有 destroy(銷毀視窗)、disable / enable(停用與啟用)、option(取得或設定屬性)、isOpen(判斷是否開啟)以及 moveToTop(移到最上層)等方法。
掌握這些屬性、事件與方法,幾乎就能應付日常九成以上的彈窗需求了。