DIV CSS 佈局教程網

封裝簡潔的 Ajax 請求處理函式:表單序列化與統一錯誤回饋
編輯:JQuery特效代碼     

專案裡的 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 重寫,可讀性會好很多。

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