專案裡的 Ajax 呼叫往往長得都差不多:抓表單、序列化、送出、處理成功與失敗。與其在每個地方重複寫一遍,不如抽成一個共用的請求函式,把錯誤處理與使用者提示統一收攏。以下是一份實際專案中的封裝寫法。
把檔案命名為 jQuery.ajaxRequest.js,呼叫時只要指定觸發元素:
$('._ajax').click(function(){
_ajax.request(this);
return false;
});
var _ajax = {
request: function(o){
var tform = $(o).parents('form');
_ar2(tform, '', '_ajax._fb_request');
},
_fb_request: function(d){
d = eval('(' + unescape(d) + ')');
// 提交狀態提示
if (d.notification) {
if (d.type == 'ok') {
alert('提交成功');
} else if (d.type == 'error') {
alert('提交失敗');
} else {
alert('錯誤');
}
}
}
}
這裡約定了一個統一的回應格式:伺服器回傳 { notification: true, type: 'ok' | 'error' },前端就能一律用同一段邏輯提示結果,不必每個請求各寫一套。
// 改進版 _ar
function _ar2(s, target, feedback, param, methods){
var url, method;
var params = {};
if ((s instanceof jQuery) && s.attr("tagName") == 'VFORM') {
url = s.attr('action');
method = s.attr('method');
params = param || $('input, textarea, select', s).serialize();
} else if ((s instanceof jQuery) && s.attr("tagName") == 'FORM') {
url = s.attr('action');
method = s.attr('method');
params = param || s.serialize();
} else if (typeof(s) == 'string') {
url = s; // 直接給網址
}
url = url || '';
method = method || methods || 'GET';
params = param ? param : params;
jQuery.ajax({
type: method, url: url, data: params,
beforeSend: function(){
// jQuery.jGrowl('數據讀取中 請稍候..', { header: '提示', theme: 'blue'});
},
success: function(data) {
if (feedback) {
eval(feedback + '(\'' + escape(data) + '\')');
return;
} else {
if (data) {
if (target) {
jQuery(target).html(data);
jQuery.jGrowl('頁面請求完畢.', { header: '提示', theme: 'green', 'life': 100});
return;
}
} else {
jQuery.jGrowl('服務器無返回信息.', { header: '提示', theme: 'blue'});
return;
}
}
jQuery.jGrowl(data, { header: '提示', theme: 'blue'});
},
error: function (e){
var s = e.status;
switch(s) {
case 404:
jQuery.jGrowl('請求的頁面無法找到. 請聯系系統管理員.', { header: '提示', theme: 'blue'});
break;
case 500:
jQuery.jGrowl('服務器錯誤[500]. 請聯系系統管理員.', { header: '提示', theme: 'blue'});
break;
default:
jQuery.jGrowl('未知錯誤. 請聯系系統管理員.', { header: '提示', theme: 'blue'});
}
}
});
}
參數來源自動判斷。傳入 jQuery 表單物件時自動抓 action、method 並序列化欄位;傳入字串時當成請求網址。呼叫端因此不必關心細節。
三種回應模式。有 feedback 函式就交給它處理;有 target 就把回應內容寫進該元素;兩者都沒有就跳提示訊息。這樣同一個函式能同時服務「局部更新」與「純通知」兩類需求。
依狀態碼分類錯誤。404、500 各給不同文案,其餘歸為未知錯誤,使用者至少能判斷該重試還是該找管理員。
提示訊息這裡用的是 jGrowl 插件,會自動消失,比 alert 打斷感低很多。
把它當成思路參考比直接複製更合適,有幾處在現代專案中必須調整。第一是 eval:無論是 eval('(' + unescape(d) + ')') 還是透過字串拼接呼叫回呼,都有執行任意程式碼的風險,應改用 JSON.parse,回呼則以函式參照傳入。第二是 escape/unescape 已廢棄且無法正確處理 UTF-8,請改用 encodeURIComponent 或直接以 JSON 傳輸。第三是 tagName 比對最好改用 is('form'),parents() 也建議換成 closest(),語意更精準。第四,若使用 jQuery 3.x,success 與 error 應改用 done/fail,或直接以 async/await 搭配 fetch 重寫,可讀性會好很多。