廢話少說,直接進主題。先看幾個 jQuery 對 ajax() 做的封裝,日常開發八成場景用它們就夠了;如果邏輯比較複雜,還是得回到 $.ajax(),後面會談到。
載入遠端 HTML 並插入 DOM。
預設用 GET 傳遞;一旦傳入了 data,就會自動切成 POST。jQuery 1.2 起還支援選擇器語法,只把過濾出來的部分插入 DOM,寫法形如 "url #some > selector"。
$(".ajax.load").load("https://www.cnblogs.com/QLeelulu/archive/2008/03/30/1130270.html .post",
function (responseText, textStatus, XMLHttpRequest) {
this; // 這裡的 this 指向目前的 DOM 元素,即 $(".ajax.load")[0]
// alert(responseText); 請求返回的內容
// alert(textStatus); 請求狀態:success、error
// alert(XMLHttpRequest); XMLHttpRequest 物件
});
注意:寫絕對路徑時在 Firefox 下容易出錯;下面的 get() 與 post() 範例都是跨域呼叫,實際測試往往拿不回結果,因此我把執行按鈕移除了。
$.get("./Ajax.aspx", { Action: "get", Name: "lulu" }, function (data, textStatus) {
// data 可以是 xmlDoc、jsonObj、html、text 等
this; // 這裡的 this 指向這次 Ajax 請求的設定資訊
alert(data);
// alert(textStatus); 注意:出錯時根本不會進入這個回呼函式
});
// Ajax.aspx
Response.ContentType = "application/json";
Response.Write("{result: '" + Request["Name"] + ",你好!(這則訊息來自伺服器)'}");
// jQuery
$.post("Ajax.aspx", { Action: "post", Name: "lulu" },
function (data, textStatus) {
alert(data.result);
}, "json");
這裡有個容易踩的坑:如果你把 type 設為 "json",卻沒有同步把伺服器的 Response.ContentType 設成 application/json,就會拿不到資料。另外因為 Accept 標頭已宣告為 json,回傳的 data 本身就是物件,不需要再用 eval() 轉換。
用 GET 方式載入並執行一支 JavaScript 檔。
1.2 版之前只能呼叫同域的 JS,1.2 之後開放跨域。要留意 Safari 2 或更早版本無法在全域作用域中同步執行腳本,若用 getScript 動態加入腳本,記得加上延遲。
$.getScript("test.js");
$.getScript("AjaxEvent.js", function () {
alert("AjaxEvent.js 已載入並執行完成。");
});
典型用途是延遲載入:例如只在編輯器取得焦點時,才去下載它需要的 JS 檔。
Ajax 請求會觸發一系列事件,可以訂閱它們來插入自己的邏輯。jQuery 把事件分成兩類:
局部事件是在每次請求的設定中個別定義的:
$.ajax({
beforeSend: function () {
// 處理 beforeSend
},
complete: function () {
// 處理 complete
}
// ...
});
全域事件則是每次請求都會觸發,並向 DOM 中所有元素廣播:
$("#loading").bind("ajaxSend", function () {
$(this).show();
}).bind("ajaxComplete", function () {
$(this).hide();
});
// 或者
$("#loading").ajaxStart(function () {
$(this).show();
});
若想在某次請求中關掉全域事件,把 global 設為 false 即可:
$.ajax({
url: "test.html",
global: false, // 停用全域 Ajax 事件
// ...
});
官方完整的 Ajax 事件清單:
這是 jQuery 的底層 AJAX 實作,$.get、$.post 都是它的高階封裝。它會回傳自己建立的 XMLHttpRequest 物件,一般情況不需要直接操作,但特殊場景下可以用來手動中止請求。
注意:如果指定了 dataType,請確認伺服器回傳正確的 MIME 型別(例如 xml 要回 text/xml),錯誤的 MIME 可能造成難以預料的行為。另外,當 dataType 設為 script 時,所有跨域的 POST 請求都會被轉為 GET。
| 參數 | 型別 | 說明 |
|---|---|---|
| url | String | 預設為目前頁位址,請求的目標網址。 |
| type | String | 預設 "GET",可設 "POST"。其他如 PUT、DELETE 也可使用,但僅部分瀏覽器支援。 |
| timeout | Number | 請求逾時時間(毫秒),會覆蓋全域設定。 |
| async | Boolean | 預設 true 為非同步。設為 false 則同步,但會鎖住瀏覽器,使用者其他操作必須等請求結束。 |
| beforeSend | Function | 送出前可修改 XMLHttpRequest 的函式,唯一參數為該物件。function (XMLHttpRequest) { this; } |
| cache | Boolean | jQuery 1.2 新增,預設 true;設為 false 則不從瀏覽器快取讀取。 |
| complete | Function | 請求結束後(不論成敗)呼叫,參數為 XMLHttpRequest 與狀態字串。 |
| contentType | String | 預設 "application/x-www-form-urlencoded",送往伺服器時的內容編碼型別,預設值適用多數場景。 |
| data | Object / String | 送往伺服器的資料,會自動轉為請求字串;GET 時附加在網址後。若為陣列,jQuery 會自動用相同名稱對應多個值,如 {foo:["bar1","bar2"]} 轉為 &foo=bar1&foo=bar2。 |
| dataType | String | 預期回應型別:xml、html、script、json、jsonp。不指定時 jQuery 會依 HTTP 標頭的 MIME 自動判斷。 其中 jsonp 會自動把 ? 替換成正確的函式名以執行回呼。 |
| error | Function | 請求失敗時呼叫,參數為 XMLHttpRequest、狀態字串、錯誤物件(通常兩者只有一個有值)。 |
| global | Boolean | 預設 true,是否觸發全域 Ajax 事件;設 false 則 ajaxStart、ajaxStop 等都不會觸發。 |
| ifModified | Boolean | 預設 false;設 true 時僅在伺服器資料有變動才取新資料,靠 Last-Modified 標頭判斷。 |
| processData | Boolean | 預設 true,會把資料轉為符合 application/x-www-form-urlencoded 的格式。若要送出 DOM 樹或其他不需轉換的內容,請設為 false。 |
| success | Function | 成功後呼叫,參數為伺服器回傳的資料與狀態字串。 |
其中 beforeSend、success、complete、error 這四個回呼參數最能派上用場,用來精細控制每一次請求。要留意的是,這些回呼裡的 this 都指向該次請求的設定物件。若打算用 jQuery 做 Ajax 開發,上面這張表值得反覆看熟。
$.ajax({
type: "get",
url: "https://www.cnblogs.com/rss",
beforeSend: function (XMLHttpRequest) {
// ShowLoading();
},
success: function (data, textStatus) {
$(".ajax.ajaxResult").html("");
$("item", data).each(function (i, domEle) {
$(".ajax.ajaxResult").append("<li>" + $(domEle).children("title").text() + "</li>");
});
},
complete: function (XMLHttpRequest, textStatus) {
// HideLoading();
},
error: function () {
// 請求出錯的處理
}
});
jQuery.ajaxSetup(options):設定全域的 Ajax 預設值。
$.ajaxSetup({
url: "/xmlhttp/",
global: false,
type: "POST"
});
$.ajax({ data: myData });
serialize() 與 serializeArray():前者把表單內容序列化成字串,後者回傳 JSON 結構的資料。
<p id="results"><b>Results: </b></p>
<form>
<select name="single">
<option>Single</option>
<option>Single2</option>
</select>
<select name="multiple" multiple="multiple">
<option selected="selected">Multiple</option>
<option>Multiple2</option>
<option selected="selected">Multiple3</option>
</select><br/>
<input type="checkbox" name="check" value="check1" /> check1
<input type="checkbox" name="check" value="check2" checked="checked" /> check2
<input type="radio" name="radio" value="radio1" checked="checked" /> radio1
<input type="radio" name="radio" value="radio2" /> radio2
</form>
serialize() 的輸出結果:

serializeArray() 的輸出結果:
