jQuery 的 Ajax 可以回傳 html、text、json、xml 等多種格式,而「怎麼把資料取出來」以及「不需要資料時怎麼寫」,是兩個都容易出錯的地方。
$.post("test.jsp",
{ name: "cssrain", time: "2008/01/21" }, // 要傳遞的數據
function (data) {
alert("返回的數據: " + data);
}
);
回傳值就是回呼函式的第一個參數 data,在該函式內處理即可。
$("#loadajax").load("test.jsp .post", function (responseText, textStatus, XMLHttpRequest) {
// 此處的 this 指向目前的 DOM 物件
});
<div id="loadajax"></div>
$.load() 除了提供回呼,本身就會把回應內容寫入選到的元素,是三者中最省事的一個。
$.ajax({
type: "get",
dataType: "json", // 回傳 json 格式的數據
url: "BackHandler.ashx",
data: "pageIndex=" + pageIndex,
complete: function () { $("#load").hide(); }, // 請求完成時隱藏 loading
success: function (msg) {
var data = msg.table;
$.each(data, function (i, n) {
var row = $("#template").clone();
row.find("#OrderID").text(n.訂單ID);
row.find("#CustomerID").text(n.客戶ID);
row.find("#OrderDate").text(ChangeDate(n.訂購日期));
row.attr("id", "ready"); // 改 id,避免與樣板衝突
row.appendTo("#datas");
});
}
});
Ajax 的回呼分 success 與 error 兩種情況。有時我們只是要「送出資料」,並不需要伺服器回傳什麼,卻仍照範本寫了 dataType: "json"——這時即使伺服器回傳 200 成功狀態,也會報錯。
原因是 jQuery 拿到空回應後,仍試圖用 JSON 解析器去解析,解析失敗便判定為錯誤並走進 error 分支。沒有回傳資料時,就不要設定 dataType。正確範本如下:
$.ajax({
type: "post",
url: "index.php",
data: "id=" + uid,
success: function () { alert(1); },
error: function () { alert(0); }
});
曾經寫過一個即時檢查信箱是否已被註冊的函式,卻總是拿到 undefined:
$.get("register.php", { check_name: "email", check_value: email_value }, function (json) {
if (json == "ok") {
$('#res_mail').html("此 email 可以註冊");
return true; // ← 這個 return 幫不到外層函式
} else {
$('#res_mail').html("此 email 已被註冊");
return false;
}
});
問題的核心是:$.get 預設是非同步的。在請求還沒完成時,外層函式就已經執行到 return 了,此時變數仍是初始值,所以永遠拿到 false。而且回呼函式內的 return 只是回傳給 Ajax 內部,對外層函式毫無影響。
解法有兩個。一是把請求改成同步(async: false),讓執行順序回到可預期:
$.get("register.php",
{ check_name: "email", check_value: email_value, async: false },
function (json) { /* ... */ }
);
二是改用 $.data() 保存狀態,事後再取出:
var boolean = false;
$.get(url, null, function (data) {
if (data.indexOf("true") >= 0) {
$("#mid").html("登陸成功");
boolean = true;
$.data("bl", boolean);
} else {
$("#mid").html("用戶名或密碼錯誤");
boolean = false;
$.data("bl", boolean);
}
});
不過老實說,async: false 會凍結整個 UI 執行緒,現代瀏覽器也已在主執行緒上全面禁用同步 XHR。真正該採用的做法是把後續邏輯寫進回呼裡,而不是試圖從非同步函式「回傳」結果:
function checkEmail(email, callback) {
$.get("register.php", { check_name: "email", check_value: email }, function (json) {
callback(json === "ok");
});
}
// 使用
checkEmail(value, function (available) {
if (available) { /* 處理可註冊的情況 */ }
});