artDialog 是一套以 JavaScript 撰寫的對話框元件,介面精緻且 API 友善。本文示範如何用它包一個表單,並透過 ajaxForm 完成非同步提交。
自適應內容
它特殊的 UI 框架能適應內容變化,即使是外部程式動態插入的內容也能自適應,因此不必預先計算訊息區塊的尺寸。它的訊息容器甚至能依寬度讓文字居中或靠左對齊,而這一切都是以 XHTML + CSS 原生實作完成的。
完善的介面
可以輕易與外部程式搭配,例如非同步寫入訊息、控制位置與尺寸、顯示隱藏、關閉等。
細節講究
非輸入狀態下支援 Esc 快捷鍵關閉;可指定在元素附近彈出;智慧地為按鈕加上焦點;黃金比例垂直居中;超大響應區域,特別為 iPad 等觸屏裝置最佳化;預先快取皮膚圖片以加快回應。
跨平台相容
相容 IE6+、Firefox、Chrome、Safari、Opera 以及 iPad 等行動裝置。即使在 IE6 下也支援現代瀏覽器的 fixed 定位、覆蓋下拉控制項、alpha 通道 PNG 背景。
接觸 artDialog 已有一段時間,用起來確實不錯。它比較輕量級——我個人在挑 JavaScript 外掛時偏好輕巧的,載入速度快。功能也很齊全,相比其他彈出外掛,這個不僅持續在維護、bug 也少,是國內比較出色的一個選擇。
示範的情境是:用 artDialog 彈出一個表單,再用 ajaxForm 提交(表單驗證可搭配 jQuery Validate 處理)。
$(document).ready(function () {
var options = {
target: '#output2',
success: showResponse // 提交後的回呼
};
$('#myForm').ajaxForm(options);
var alt = null;
$("#addHname").click(function () {
alt = art.dialog({
title: '新增花名',
content: document.getElementById('g_cn'),
width: 750,
button: [
{
name: '保存',
focus: true,
callback: function () {
$('#myForm').submit();
return false;
}
},
{
name: '關閉',
callback: function () {
alt.close();
}
}
]
});
});
function showResponse(data) {
if (alt != null) {
alt.close();
}
if (data == 'success') {
artDialog.alert('保存成功');
} else {
artDialog.alert('保存失敗');
}
}
});
回呼中的 return false 至關重要。artDialog 的按鈕回呼若回傳 false,視窗不會自動關閉。這裡刻意回傳 false,把關閉的控制權交給 showResponse——因為要不要關,取決於伺服器端是否真的儲存成功。若省略這行,視窗會在請求還沒回來之前就消失,使用者無從得知結果。
把 dialog 實例存成變數。用 alt 保存 art.dialog() 的回傳值,才能在別的地方呼叫 close()。這是操作彈出視窗生命週期的標準做法。
content 傳的是 DOM 節點。範例中傳入 document.getElementById('g_cn') 而非 HTML 字串,這樣表單內既有的值與事件綁定都能保留下來。若傳字串,DOM 會被重建,狀態就丟了。
表單應在頁面中就存在。由於 ajaxForm 是在 ready 階段綁定的,表單元素必須先存在於文件上,只是被 artDialog 移動到彈跳層中顯示。若表單是動態產生的,就必須在產生後重新呼叫 ajaxForm。
範例中的錯誤處理略嫌簡略——不論什麼原因失敗都只顯示同一句話。實務上建議讓後端回傳結構化的結果(含錯誤碼與訊息),前端再據此顯示具體原因,例如「名稱已重複」或「網路異常,請重試」。
另外,表單開啟後應把焦點放在第一個輸入欄位,並在關閉時清空欄位值,避免下次開啟時殘留上一次的輸入。這兩個小細節對使用體驗的影響往往比想像中大。
需要補充的是,artDialog 屬於上一代的彈跳視窗方案,其官方版本已多年未更新,部分 API 也依賴舊版 jQuery 的行為。新專案若需要對話框功能,建議改用仍在維護的方案(如 layer、SweetAlert2、或各家 UI 框架自帶的 Dialog 元件),並搭配無障礙屬性(role="dialog"、aria-modal)確保鍵盤操作與螢幕閱讀器可用性。本文的價值主要在於它示範的「非同步提交 + 條件式關閉」這個通用模式,這個思路在任何彈跳視窗元件上都適用。