今天我們用 jQuery UI 的 dialog 做一個彈窗特效。成品有幾個特點:點擊時出現、預設置中、而且可以用滑鼠拖動。實現這些只需要很少的程式碼。

關鍵在於初始化 dialog 時設 autoOpen: false,讓它先建立但不顯示;點擊時只要呼叫 dialog('open') 就搞定了。
$('#pop').dialog({
autoOpen: false,
modal: true,
title: '提示',
width: 400,
height: 300,
resizable: true,
draggable: true
});
$('#showBtn').click(function() {
$('#pop').dialog('open');
});
拖曳與置中都是 dialog 內建的,不需要自己寫座標計算。這就是借助成熟元件的價值——你要的行為它已經做完了,你只要決定要不要開。

彈窗裡通常要放內容。範例還示範了用 jQuery 的 appendTo 動態插入一列資料:
$('#insertBtn').click(function() {
var name = $('#nameInput').val();
var html = '<tr><td>' + name + '</td></tr>';
$(html).appendTo('#dataTable');
});
先用變數接住輸入框的值,接著組出一段 HTML 字串,然後 appendTo 到表格裡,資料列就出現了。當然這只是前端示範,並沒有真的寫入資料庫。

autoOpen 為什麼重要。預設 autoOpen 是 true,dialog 在頁面載入時就會跳出來——這幾乎從來不是你想要的。設成 false,把「何時顯示」的決定權交給使用者操作,是正確的預設。
重複點擊不要重複初始化。若每次點擊都再呼叫一次 $('#pop').dialog({...}),會重新套用設定甚至造成異常。正確做法是初始化一次,之後只切換狀態:
$('#showBtn').click(function() {
var dlg = $('#pop');
if (dlg.dialog('isOpen')) { dlg.dialog('close'); } // 已開就關
else { dlg.dialog('open'); }
});
modal 選項決定要不要遮罩。modal: true 會產生半透明背景並阻擋互動,適合需要強制使用者處理的對話框(例如確認刪除);設為 false 則是非強制性的提示,使用者可以繼續操作背景。選哪個是 UX 決定,不是技術決定。
用 element 而非 id 選 dialog 的內容。dialog 會把內容元素包進一個自己產生的容器並移動它在 DOM 中的位置。若你的其他程式碼依賴原本的 DOM 結構,可能會因此出錯。
動態插入 HTML 有 XSS 風險。上面那個 '<tr><td>' + name + '</td></tr>',若 name 是使用者輸入且含 <script>,就會被執行。安全做法是用 DOM API 建立元素並用 .text() 填入文字:
var tr = $('<tr></tr>');
var td = $('<td></td>').text(name); // text 會自動跳脫
tr.append(td);
$('#dataTable').append(tr);
關閉事件要用來清理。彈窗裡若有表單、有暫存狀態、有定時器,應該在 close 事件裡處理:
$('#pop').dialog({
autoOpen: false,
close: function() {
$('#nameInput').val(''); // 重設表單
$('#dataTable').empty(); // 清掉暫存資料
}
});
無障礙。jQuery UI 的 dialog 在這方面做得比多數自製彈窗好:它會自動加上 role="dialog"、aria-modal,並把焦點移入彈窗、關閉後歸還。但若你在內容裡放了新的互動元素,仍要確認鍵盤順序合理、每個控制項都有可讀的名稱。
這段程式碼的價值不在技術難度,而在它示範了一個觀念:成熟元件把「難的部分」做完了。置中計算、拖曳邊界、遮罩層、焦點管理、ESC 關閉——這些自己寫每一項都是坑,而 jQuery UI 已經處理過。
今天的對應方案是 <dialog> 元素搭配 showModal(),原生支援 modal 行為、焦點鎖定與 ESC 關閉:
const dlg = document.querySelector('dialog');
document.querySelector('#showBtn').onclick = () => dlg.showModal();
dlg.querySelector('.close').onclick = () => dlg.close();
不需要任何外部程式庫。若需要拖曳、縮放、動畫這些額外行為,才考慮引入套件。