$.ajax() 是 jQuery 做非同步請求的核心方法,參數多到有點嚇人。但其實常用的就那幾個,剩下的多半在特定情境才需要。以下依用途分類整理。
$.ajaxSetup() 的全域設定。application/x-www-form-urlencoded,絕大多數情況都用這個就好。data 可傳 Object 或 String。傳物件時 jQuery 會自動轉成查詢字串:{foo1:"bar1", foo2:"bar2"} 變成 &foo1=bar1&foo2=bar2;陣列值則會產生同名多值,例如 {foo:["bar1","bar2"]} 轉為 &foo=bar1&foo=bar2。get 請求時會附加在 url 後面。
dataType 是預期伺服器回傳的型別,不指定則由 jQuery 依 HTTP 的 mime 資訊自行判斷:
xml:回傳 XML 文件,可直接用 jQuery 查詢。html:純文字 HTML,插入 DOM 時其中的 script 標籤會被執行。script:純文字 JavaScript,結果預設不快取。跨網域時所有 post 都會被轉成 get。json:JSON 資料。jsonp:JSONP 格式,用於跨網域。像 myurl?callback=? 這樣呼叫時,jQuery 會自動把最後那個問號替換成正確的函式名。text:純文字字串。beforeSend: function(XMLHttpRequest){ /* 可改寫 header,return false 可取消請求 */ },
complete : function(XMLHttpRequest, textStatus){ /* 成功或失敗都會呼叫 */ },
success : function(data, textStatus){ /* 僅成功時呼叫 */ },
error : function(XMLHttpRequest, textStatus, errorThrown){ /* 僅失敗時呼叫 */ }
每個回呼裡的 this 都指向本次 ajax 呼叫時傳入的 options 物件,這個特性在混用多個請求時很好用。
$(function(){
$('#send').click(function(){
$.ajax({
type: "GET",
url: "test.json",
data: { username: $("#username").val(), content: $("#content").val() },
dataType: "json",
success: function(data){
$('#resText').empty();
var html = '';
$.each(data, function(commentIndex, comment){
html += '<div class="comment"><h6>' + comment['username']
+ ':</h6><p class="para">' + comment['content'] + '</p></div>';
});
$('#resText').html(html);
}
});
});
});
$.each() 是全域函式,與 jQuery 物件的 .each() 方法不同:它不操作 jQuery 物件,而是以陣列或物件當第一個參數、回呼函式當第二個參數。回呼的兩個參數分別是成員索引(或鍵名)與對應的值。