ExtJS 提供的不只是一種 Ajax 提交途徑,而是四種風格各異的做法。理解它們的差異,才能依場景選對工具。
最底層的方式,需要自己封裝待傳遞的參數:
/**
* 第一種 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() {
}
});
}
優點是完全掌控,缺點是每個欄位都要手動取值組裝,表單一多就很繁瑣。
透過 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 的 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 欄位。
用 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);
}
});
}
這份程式碼基於 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),而不是只依賴前端驗證。