萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery UI Dialog 完整使用指南:從基礎到模態對話框

jQuery UI Dialog 是構建網頁彈出層、確認框、表單彈窗的經典組件。本文系統梳理其引用依賴、初始化配置、模態模式、按鈕定製、顯示/隱藏控制等核心用法,助你快速上手。

1. 環境準備:引用必要文件

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)。

2. 基礎初始化:自動開啟的簡單對話框

<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>

3. 進階控制:按鈕觸發、延遲開啟、模態遮罩

3.1 隱藏初始狀態,按鈕觸發開啟

<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>

3.2 常用配置選項速查表

選項類型預設值說明
autoOpenBooleantrue初始化時是否自動打開
modalBooleanfalsetrue 時顯示半透明遮罩,禁止背景操作
resizableBooleantrue是否允許拖曳調整大小
draggableBooleantrue是否允許拖曳移動位置
width / heightNumber/Stringauto固定寬高,如 400 或 'auto'
closeOnEscapeBooleantrueEsc 鍵關閉對話框
show / hideString/Objectnull動畫效果,如 'fade', 'slide', { effect: 'blind', duration: 300 }

4. 程式化操作常用方法

  • $("#dialog").dialog("open") — 打開對話框
  • $("#dialog").dialog("close") — 關閉對話框
  • $("#dialog").dialog("destroy") — 徹底銷毀實例,移除 DOM 綁定
  • $("#dialog").dialog("option", "title", "新標題") — 動態修改標題
  • $("#dialog").dialog("widget") — 取得對話框外層容器 jQuery 物件,便於進一步樣式調整

5. 常見坑點與最佳實踐

  1. 表單提交問題:對話框預設附加到 <body>,導致 ASP.NET/WebForms 控制項失效。解決:$("#dialog").parent().appendTo("form:first")(參考文章 71410)。
  2. 重複初始化:對同一元素多次呼叫 .dialog() 會報錯。先用 if (!$("#dialog").hasClass("ui-dialog-content")) 判斷或銷毀後重建。
  3. z-index 層級衝突:若頁面有固定定位的 Header/Modal,需在 CSS 中調整 .ui-dialog 的 z-index 或使用 dialogClass 選項指定自定義類別。
  4. 內容動態載入:搭配 .load(url) 或 AJAX 獲取內容後再 .dialog("open"),注意在回調中初始化 Dialog。

6. 完整範例:AJAX 載入內容的模態編輯框

<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 構建優雅的交互體驗。

copyright © 萬盛學電腦網 all rights reserved