DIV CSS 佈局教程網

ExtJS 中四種 Ajax 表單提交方式對照
編輯:JavaScript綜合知識     

ExtJS 提供的不只是一種 Ajax 提交途徑,而是四種風格各異的做法。理解它們的差異,才能依場景選對工具。

第一種:直接呼叫 Ext.Ajax.request

最底層的方式,需要自己封裝待傳遞的參數:

/**
 * 第一種 Ajax 提交方式
 * 直接使用 ext Ajax 方法進行提交
 * 需要將待傳遞的參數進行封裝
 */
function saveUser_ajaxSubmit1() {
    Ext.Ajax.request({
        url: 'user_save.action',
        method: 'post',
        params: {
            userName: document.getElementById('userName').value,
            password: document.getElementById('password').value
        },
        success: function(response, options) {
            var o = Ext.util.JSON.decode(response.responseText);
            alert(o.msg);
        },
        failure: function() {
        }
    });
}

優點是完全掌控,缺點是每個欄位都要手動取值組裝,表單一多就很繁瑣。

第二種:指定既有 HTML 表單

透過 form 設定項指向一個 HTML 表單 id,ExtJS 會自動收集表單內所有欄位:

/**
 * 第二種 Ajax 提交方式
 * 為 ext 的 ajax 指定一個 html 表單
 * 不需要手動封裝參數
 */
function saveUser_ajaxSubmit2() {
    Ext.Ajax.request({
        url: 'user_save.action',
        method: 'post',
        form: 'userForm',        // 指定表單
        success: function(response, options) {
            var o = Ext.util.JSON.decode(response.responseText);
            alert(o.msg);
        },
        failure: function() {
        }
    });
}

這種方式最省事,前提是頁面上已經有一個傳統的 HTML 表單。

第三種:使用 ExtJS 自己的表單元件

若表單是用 ExtJS 的 FormPanel 建的,就用它的 submit() 方法。這種方式還能內建欄位驗證:

/**
 * 第三種 Ajax 提交方式
 * 提交 ext 自己的表單
 * 需要使用 ext 自己的 textField 元件
 */
function saveUser_ajaxSubmit3() {

    // 定義表單
    var formPanel = new Ext.FormPanel({
        labelWidth: 75,
        frame: true,
        bodyStyle: 'padding:5px 5px 0',
        width: 350,
        defaults: { width: 230 },
        defaultType: 'textfield',
        items: [
            { fieldLabel: '用戶名', name: 'userName', allowBlank: false },
            { fieldLabel: '密 碼', name: 'password' }
        ]
    });

    // 定義視窗
    var win = new Ext.Window({
        title: '添加用戶',
        layout: 'fit',
        width: 500,
        height: 300,
        closeAction: 'close',
        closable: false,
        plain: true,
        items: formPanel,
        buttons: [
            {
                text: '確定',
                handler: function() {
                    var form = formPanel.getForm();
                    var userName = form.findField('userName').getValue().trim();
                    var password = form.findField('password').getValue().trim();

                    if (!userName) { alert('用戶名不能為空'); return; }
                    if (!password) { alert('密碼不能為空'); return; }

                    form.submit({
                        waitTitle: '請稍後...',
                        waitMsg: '正在保存用戶信息,請稍後...',
                        url: 'user_save.action',
                        method: 'post',
                        success: function(form, action) {
                            alert(action.result.msg);
                        },
                        failure: function(form, action) {
                            alert(action.result.msg);
                        }
                    });
                }
            },
            {
                text: '取消',
                handler: function() { win.close() }
            }
        ]
    });

    win.show();
}

值得注意的幾個細節:allowBlank: false 是 ExtJS 的必填驗證;waitMsg 會自動顯示等待遮罩;回調中的 action.result 是伺服器回傳的 JSON 物件,可直接取用其中的 msg 欄位。

第四種:把 HTML 表單轉為 ExtJS 表單

用 Ext.form.BasicForm 包裝既有的 HTML 表單,就能取得 ExtJS 的提交能力,同時保留原本的 HTML 結構:

/**
 * 第四種 Ajax 提交方式
 * 將 html 的表單轉化為 ext 的表單進行異步提交
 * 需要事先定義好 html 的表單
 */
function saveUser_ajaxSubmit4() {
    new Ext.form.BasicForm('userForm').submit({
        waitTitle: '請稍後...',
        waitMsg: '正在保存用戶信息,請稍後...',
        url: 'user_save.action',
        method: 'post',
        success: function(form, action) {
            alert(action.result.msg);
        },
        failure: function(form, action) {
            alert(action.result.msg);
        }
    });
}

四種方式該怎麼選

  • 方式一:適合非表單場景,例如參數來自多個不相關的元件、或需要動態組裝查詢條件。
  • 方式二:表單已是傳統 HTML,想快速加上 Ajax 提交能力。
  • 方式三:整個表單由 ExtJS 建構,需要完整的元件驗證與視覺一致性。
  • 方式四:HTML 結構由後端樣板產生,但希望借用 ExtJS 的提交與等待提示。

幾點提醒

這份程式碼基於 ExtJS 3.x 的語法(new Ext.FormPanel、Ext.util.JSON.decode)。ExtJS 4 之後 API 有相當大的變動,改為 Ext.create() 與 xtype 導向的寫法,Ext.util.JSON.decode 也已被 Ext.decode() 取代。若你在維護新版本專案,請對照該版本的 API 文件。

另外,無論用哪一種方式,密碼欄位都不應以純文字傳輸。務必確認 request 走的是 HTTPS,並在伺服器端對密碼做適當的雜湊處理(bcrypt、scrypt 或 Argon2),而不是只依賴前端驗證。

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