Ajax 是一套與伺服器交換資料的技術,讓開發者能在不重新載入整頁的情況下更新部分內容。jQuery 把原生 XHR 的繁瑣細節包了起來,提供四個高頻使用的方法。
$.ajax() 回傳它建立的 XMLHttpRequest 物件。它只接受一個參數:包含各項設定與回呼函式的鍵值對物件。
若指定了 dataType,請確保伺服器回傳正確的 MIME 型別(例如 XML 應回 text/xml,JSON 應回 application/json),否則 jQuery 可能無法正確解析。
$.ajax({
type: "post",
dataType: "html",
url: '/Resources/GetList.ashx',
data: dataurl,
success: function (data) {
if (data !== "") {
var parts = data.split("$$");
$("#pager").pager({
pagenumber: pagenumber,
pagecount: parts[1],
buttonClickCallback: PageClick
});
$("#anhtml").html(parts[0]);
}
},
error: function (xhr, status, err) {
console.error("請求失敗:", status, err);
}
});
注意範例中已補上 error 回呼——只用 success 是最常見的疏漏,失敗時畫面會靜默地毫無反應。
這是 GET 請求的簡化寫法,適合取代較簡單的 $.ajax。請求成功時可呼叫回呼;若需要在出錯時處理,請直接用 $.ajax。
$.get("test.cgi", { name: "John", time: "2pm" }, function (data) {
alert("Data Loaded: " + data);
});
同樣是簡化寫法,用於需要傳送較多資料或會更動伺服器狀態的場合。
$.post("/Resources/addfriend.ashx",
{ "fid": fids, "fname": fnames, "tuid": tuids, "tuname": tunames },
function (data) {
if (data === "ok") { alert("添加成功!"); }
}
);
它等價於 $.get(url, data, callback, "json"),並支援 JSONP 形式的跨網域請求。
$.getJSON("https://api.flickr.com/services/feeds/photos_public.gne?tags=cat&tagmode=any&format=json&jsoncallback=?",
function (data) {
$.each(data.items, function (i, item) {
$("<img/>").attr("src", item.media.m).appendTo("#images");
if (i === 3) { return false; } // 只取前四張
});
}
);
$.ajax()。$.get() 或 $.getJSON()。$.post()。jQuery 已不再主動開發新版本,新專案若尚未採用,可考慮 fetch() 或 axios。但上述四種方法的觀念完全通用——請求方式、url、data、dataType、success 與 error 這幾個要素,在任何一套工具中都是同一組。理解它們,換框架時只是改寫法。
另外,若要讓錯誤處理不必每處重寫,可用 $(document).ajaxError() 綁定全域錯誤回呼,統一提示或記錄,這比在每個請求裡重複設定乾淨得多。