DIV CSS 佈局教程網

jQuery UI Dialog 實作可拖曳置中彈窗
編輯:JavaScript綜合知識     

用 jQuery UI 的 dialog 做彈窗,只要一行 .dialog() 就能得到置中、可拖曳、可縮放、有標題列的視窗——這些細節自己刻要花好幾天。

看效果:點擊按鈕後彈窗出現,位置在畫面正中央,而且可以用滑鼠拖著標題列四處移動。

核心寫法:不要 autoOpen

$("#pop").dialog({
  autoOpen: false,   // 關鍵:載入時不要自動開啟
  modal: true,       // 加上遮罩,且未關閉前無法操作背後內容
  draggable: true,   // 可拖曳
  resizable: false,  // 不讓使用者縮放,維持版面
  title: "系統提示",
  width: 400,
  buttons: {
    "確定": function () { $(this).dialog("close"); },
    "取消": function () { $(this).dialog("close"); }
  }
});

// 點擊時才開
$("#openBtn").click(function () {
  $("#pop").dialog("open");
});

autoOpen: false 是整個模式的關鍵。dialog 預設會在初始化時立刻彈出,對「點擊才出現」的需求毫無用處。關掉它之後,就能用 $("#pop").dialog("open") 在任意時機開啟。

jQuery UI 會自動幫你加上 ui-dialog 系列的 class,並把 dialog 包進一層新的容器 div。所以指定寬高、改樣式時,要對 .ui-dialog 下手,而不是對原本的 #pop。

動態插入內容

彈窗裡的資料通常是動態產生的。這裡用 jQuery 的 appendTo 把新的一列插進表格:

function addRow(name, value) {
  var html = "<tr><td>" + name + "</td><td>" + value + "</td></tr>";
  $(html).appendTo("#dataTable tbody");
}

// 開窗前先帶入資料
$("#openBtn").click(function () {
  $("#pop").dialog("open");
  addRow("產品名稱", $("#pname").val());
});

流程是:先從變數或輸入框取值,組出一段 HTML 字串,再 appendTo 到目標容器的 tbody 裡。注意一定要指向 tbody 而非 table——直接 append 到 table 在部分瀏覽器上會被忽略或放到錯誤的位置。

這裡有個安全問題要修

用字串拼接 HTML 來插入使用者輸入的內容,會直接形成 XSS 漏洞。若 name 或 value 含有 <script>,它會被當成程式碼執行。正確做法是用 DOM API 建立節點並以 textContent 填入文字:

var $tr = $("<tr>").appendTo("#dataTable tbody");
$("<td>").text(name).appendTo($tr);   // text() 會自動轉義
$("<td>").text(value).appendTo($tr);

用 .text() 而非 .html(),jQuery 會自動處理轉義,這是必須養成的習慣。

幾個實務設定

modal: true:加上遮罩層,讓使用者明確知道「現在必須先處理這個視窗」。但也會阻斷背後的所有操作,若彈窗只是補充資訊,設為 false 更合適。

closeOnEscape:預設 true,按 Esc 可關閉。這是鍵盤使用者的必要途徑,不要關掉。

開啟後設定焦點:使用 open 回呼把焦點移到彈窗內的第一個可互動元素,鍵盤使用者才能立即操作。

關閉後歸還焦點:把焦點還給開啟它的那顆按鈕,否則使用者的 Tab 順序會斷掉。

現代替代方案

瀏覽器已原生支援 <dialog> 元素:呼叫 dialog.showModal() 就有等同 modal: true 的效果,並自動處理焦點鎖定與 Esc 關閉,不必載入任何函式庫:

<dialog id="pop">
  <form method="dialog">
    <button value="ok">確定</button>
  </form>
</dialog>

document.getElementById("openBtn")
        .addEventListener("click", () => document.getElementById("pop").showModal());

這個原生方案在無障礙支援上比 jQuery UI 完整得多,是值得優先考慮的選擇。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved