DIV CSS 佈局教程網

jquery.ajax 的 beforeSend:實作請求中的 loading 提示
編輯:JQuery特效代碼     

AJAX 請求送出後到回應抵達之間總會有延遲,若畫面沒有任何回饋,使用者往往會以為壞掉了、反覆點擊。beforeSend 就是在這種情境下派上用場的鉤子:它在請求即將送出的那一刻被觸發,讓你先顯示轉圈的 loading 圖示或「資料載入中」的提示。

基本骨架

把 $.ajax 的六個主要回呼都列出來,會很容易看出各自的職責分工。

代碼如下:

function test_ajax() {
    $.ajax({
        type: "GET",                 // 常用 GET / POST,預設 GET
        url: "a.php",            // 請求位址,預設為目前頁
        dataType: "html",        // 預期回應的資料型別
        beforeSend: beforeSend,   // 送出前
        success: callback,         // 成功
        error: error,               // 失敗
        complete: complete         // 不論成功失敗都執行
    });
}

function error(XMLHttpRequest, textStatus, errorThrown) {
    // textStatus 與 errorThrown 通常只有一個有值
    $("#showResult").append("<div>請求出錯啦!</div>");
}

function beforeSend(XMLHttpRequest) {
    $("#showResult").append("<div><img src='loading.gif' /></div>");
}

function complete(XMLHttpRequest, textStatus) {
    $("#showResult").remove();
}

function callback(msg) {
    $("#showResult").append("<div>請求成功,回傳資料:" + msg + "</div>");
}

beforeSend 的定位

它是一個 AJAX 全域/局部事件,在請求開始前觸發,主要用途是讓你有機會修改 XMLHttpRequest 物件,例如加掛自訂的 request header、取消請求(在函式中回傳 false 即可中止),或是像本例這樣先插入 loading 提示。關於事件順序的完整說明可參考 jQuery 官方文件。

另一種更省的做法:預留佔位文字

很多網站的做法是把容器先填上一段「資料載入中,請稍候」,等回應到了再用 ID 選擇器把內容替換掉。這招比動態插入再移除 DOM 更省事,也不會有 loading 圖閃一下就被推翻的突兀感。

該怎麼選?判斷依據是「請求前後你操作的是不是同一個 DOM 節點」。如果提示與最終內容共用同一個容器,用文字替換最乾淨;如果你需要在請求期間額外做別的事(例如禁用按鈕、顯示進度、設定 timeout),那就用 beforeSend 來處理。另外别忘了在 complete 或 error 裡務必把 loading 收掉,否則請求失敗時轉圈圖會一直留在畫面上。

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