DIV CSS 佈局教程網

artDialog 彈跳視窗提交表單的完整思路:搭配 ajaxForm 實作
編輯:關於JavaScript     

artDialog 是一套以 JavaScript 撰寫的對話框元件,介面精緻且 API 友善。本文示範如何用它包一個表單,並透過 ajaxForm 完成非同步提交。

為什麼選 artDialog

自適應內容
它特殊的 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)確保鍵盤操作與螢幕閱讀器可用性。本文的價值主要在於它示範的「非同步提交 + 條件式關閉」這個通用模式,這個思路在任何彈跳視窗元件上都適用。

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