jQuery UI Dialog 是構建網頁彈出層、確認框、表單彈窗的經典組件。本文系統梳理其引用依賴、初始化配置、模態模式、按鈕定製、顯示/隱藏控制等核心用法,助你快速上手。
Dialog 依賴 jQuery 核心庫及多個 UI 核心模組,建議直接引用打包後的 jquery-ui.min.js 及對應主題 CSS:
<!-- jQuery 核心 -->
<script src="scripts/jquery-1.4.2.min.js"></script>
<!-- jQuery UI 打包版(含 core, widget, mouse, draggable, position, dialog 等) -->
<script src="scripts/jquery-ui.min.js"></script>
<!-- 主題樣式(如 redmond、smoothness 等) -->
<link rel="stylesheet" href="styles/jquery-ui.min.css" />
注意:若手動引用分模組文件,須確保載入順序正確(core → widget → mouse → draggable → position → dialog)。
<div id="dialog-confirm" title="清空回收站?">
<p><span class="ui-icon ui-icon-alert" style="float:left; margin:0 7px 20px 0;"></span>
這些項目將被永久刪除且無法恢復。確定要繼續嗎?</p>
</div>
<script>
$(function () {
$("#dialog-confirm").dialog(); // 預設 autoOpen: true,頁面載入即顯示
});
</script>
<div id="dialog-confirm" title="確認刪除" style="display:none;">...</div>
<input type="button" id="btnDelete" value="刪除" />
<script>
$(function () {
$("#dialog-confirm").dialog({
autoOpen: false, // 僅初始化,不自動顯示
modal: true, // 啟用模態遮罩,鎖定背景交互
buttons: {
"確定": function () {
$(this).dialog("close");
// 此處執行實際刪除邏輯(AJAX/Postback)
},
"取消": function () {
$(this).dialog("close");
}
}
});
$("#btnDelete").click(function () {
$("#dialog-confirm").dialog("open");
});
});
</script>
| 選項 | 類型 | 預設值 | 說明 |
|---|---|---|---|
| autoOpen | Boolean | true | 初始化時是否自動打開 |
| modal | Boolean | false | true 時顯示半透明遮罩,禁止背景操作 |
| resizable | Boolean | true | 是否允許拖曳調整大小 |
| draggable | Boolean | true | 是否允許拖曳移動位置 |
| width / height | Number/String | auto | 固定寬高,如 400 或 'auto' |
| closeOnEscape | Boolean | true | Esc 鍵關閉對話框 |
| show / hide | String/Object | null | 動畫效果,如 'fade', 'slide', { effect: 'blind', duration: 300 } |
$("#dialog").dialog("open") — 打開對話框$("#dialog").dialog("close") — 關閉對話框$("#dialog").dialog("destroy") — 徹底銷毀實例,移除 DOM 綁定$("#dialog").dialog("option", "title", "新標題") — 動態修改標題$("#dialog").dialog("widget") — 取得對話框外層容器 jQuery 物件,便於進一步樣式調整<body>,導致 ASP.NET/WebForms 控制項失效。解決:$("#dialog").parent().appendTo("form:first")(參考文章 71410)。.dialog() 會報錯。先用 if (!$("#dialog").hasClass("ui-dialog-content")) 判斷或銷毀後重建。.ui-dialog 的 z-index 或使用 dialogClass 選項指定自定義類別。.load(url) 或 AJAX 獲取內容後再 .dialog("open"),注意在回調中初始化 Dialog。<button id="btnEdit" data-id="123">編輯</button>
<div id="editDialog" style="display:none;"></div>
<script>
$("#btnEdit").click(function () {
var $dlg = $("#editDialog");
$dlg.load("EditForm.aspx?id=" + $(this).data("id"), function () {
$dlg.dialog({
title: "編輯記錄",
width: 500,
modal: true,
buttons: {
"儲存": function () {
// 表單驗證 + AJAX 提交
if ($("#editForm").valid()) {
$.post("SaveHandler.ashx", $("#editForm").serialize(), function (res) {
if (res.success) $dlg.dialog("close");
});
}
},
"取消": function () { $dlg.dialog("close"); }
}
}).dialog("open");
});
});
</script>
掌握上述核心用法,即可在專案中靈活運用 jQuery UI Dialog 構建優雅的交互體驗。