自己寫遮罩加彈窗要處理定位、層級、關閉、鍵盤操作一堆細節,而 jQuery UI 的 Dialog 插件把這些都包好了,只需要宣告一次並在需要時呼叫 open。以下示範基本用法與常見設定。
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>彈框遮罩效果</title>
<style type="text/css">
#dialog_link {padding: .4em 1em .4em 20px; text-decoration: none; position: relative;}
#dialog_link span.ui-icon {margin: 0 5px 0 0; position: absolute; left: .2em; top: 50%; margin-top: -8px;}
</style>
<script type="text/javascript" language="javascript" src="jquery-1.7.1.min.js">
</script>
<script type="text/javascript" language="javascript" src="jquery-ui-1.8.18.custom.min.js">
</script>
<link rel="stylesheet" href="ui-lightness/jquery-ui-1.8.18.custom.css"/>
<script type="text/javascript" language="javascript">
$(function(){
$("#dialog").dialog({
autoOpen: false,
buttons: [{
text: "ok",
click: function(){
$("#dialog").dialog("close");
}
}, {
text: "cancal",
click: function(){
$("#dialog").dialog("close");
}
}],
position: "top", // 彈出位置
width: 600, // 視窗寬度
height: 200,
drag: function(){
alert("你干拽我試試");
}
});
$("#dialog_link").click(function(){
$("#dialog").dialog("open");
});
})
</script>
</head>
<body>
<a href="#" id="dialog_link" class="ui-state-default ui-corner-all"><span class="ui-icon ui-icon-newwin"></span>Open Dialog</a>
<!-- 對話框在頁面中預設是隱藏的 -->
<div id="dialog" title="Hi" style="display:none">
hello
</div>
</body>
</html>
把 autoOpen 保持 false,改用 modal: true 讓背景不可互動,並在按鈕回呼裡讀取表單值:
<script type="text/javascript" language="javascript">
$(function(){
$("#dialog").dialog({
autoOpen: false,
modal: true,
buttons: [{
text: "ok",
click: function(){
// 這裡可以讀取 #dialog 內的表單欄位並送出
$("#dialog").dialog("close");
}
}, {
text: "cancal",
click: function(){
$("#dialog").dialog("close");
}
}],
position: "top",
width: 600,
height: 200,
drag: function(){
alert("你干拽我試試");
}
});
$("#dialog_link").click(function(){
$("#dialog").dialog("open");
});
})
</script>
</head>
<body>
<a href="#" id="dialog_link" class="ui-state-default ui-corner-all"><span class="ui-icon ui-icon-newwin"></span>Open Dialog</a>
<div id="dialog" title="Hi" style="display:none">
hello
</div>
</body>
</html>
autoOpen: false 很重要。預設為 true 時,dialog 會在頁面載入後立刻彈出;設為 false 才能改由使用者操作觸發。
modal: true 會加上遮罩層並阻擋背景互動,同時讓 Tab 鍵的焦點留在對話框內。需要強制使用者先做選擇時就該開啟。
buttons 接受按鈕陣列,每個物件有 text 與 click。這比自己在 HTML 裡寫按鈕再綁事件乾淨,插件會自動套用主題樣式。
position 除了 'top'、'center' 這類關鍵字,也可以用 { my: "center", at: "center", of: window } 對齊到特定元素。
drag 這裡寫的是 drag 事件,會在每次拖曳移動時觸發,所以 alert 會連續跳出——實務上應該改用 stop 事件,或干脆拿掉這個示範用的回呼。
這個範例基於 jQuery UI 1.8,其中的 $.browser、以及 Dialog 的部分 API 在後續版本有變動;1.10 之後 buttons 的 text 寫法仍可用,但整體建議對照所用版本的官方文件確認。另外別忘了引入主題 CSS(範例中的 ui-lightness),少了它對話框會完全沒有樣式。
最後,Dialog 內的內容若是動態載入的,記得在 open 事件裡再初始化其中的元件(例如日期選擇器),因為這些元素在頁面 ready 時可能還是隱藏狀態,部分插件在隱藏容器中初始化會算出錯誤尺寸。