DIV CSS 佈局教程網

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

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

核心寫法:不要 autoopen

關鍵在於初始化 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();

不需要任何外部程式庫。若需要拖曳、縮放、動畫這些額外行為,才考慮引入套件。

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