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>");
}
它是一個 AJAX 全域/局部事件,在請求開始前觸發,主要用途是讓你有機會修改 XMLHttpRequest 物件,例如加掛自訂的 request header、取消請求(在函式中回傳 false 即可中止),或是像本例這樣先插入 loading 提示。關於事件順序的完整說明可參考 jQuery 官方文件。
很多網站的做法是把容器先填上一段「資料載入中,請稍候」,等回應到了再用 ID 選擇器把內容替換掉。這招比動態插入再移除 DOM 更省事,也不會有 loading 圖閃一下就被推翻的突兀感。
該怎麼選?判斷依據是「請求前後你操作的是不是同一個 DOM 節點」。如果提示與最終內容共用同一個容器,用文字替換最乾淨;如果你需要在請求期間額外做別的事(例如禁用按鈕、顯示進度、設定 timeout),那就用 beforeSend 來處理。另外别忘了在 complete 或 error 裡務必把 loading 收掉,否則請求失敗時轉圈圖會一直留在畫面上。