jQuery 把 Ajax 操作做了分層封裝:最上層是 load、$.get、$.post、$.getScript、$.getJSON 這些好用的捷徑,最底層則是 $.ajax()。先從上層看起,最後再回頭理解底層。
load(url [, data] [, callback])
最簡單的用法只要一行:
$("#resText").load("comment.html");
它也可以只載入page中的某個片段,語法是「url 空白 selector」:
$("#resText").load("comment.html .contentTxt");
傳輸方式會依 data 自動判斷:沒傳 data 用 GET,有傳就自動改成 POST。
搭配回調:
$("#resText").load("comment.html", function (responseText, textStatus, XMLHttpRequest) {
alert(responseText); // 回應內容
alert(textStatus); // 請求狀態
});
load() 最適合用來取靜態的 HTML 片段。若需要向伺服器傳參數,改用 $.get() 或 $.post()。
$.get(url [, data] [, callback] [, type]) $.post(url [, data] [, callback] [, type])
四個參數分別是請求位址、以 key/value 組成的資料、成功時呼叫的函式,以及預期的回應格式。
兩者的差異在語意:GET 應該是「讀取」,多次呼叫結果一致,不改變伺服器狀態;POST 則用來「修改」,例如新增或刪除。實作上還有幾點實際影響:
中文參數記得用 encodeURI() 編碼,回來再用 decodeURI() 還原,否則會亂碼。若預期回傳 JSON,把第四個參數設為 "json":
$.get("get2.jsp", { username: encodeURI($("#username").val()) }, function (data, textStatus) {
var username = decodeURI(data.username);
$("#resText").html(txtHtml);
}, "json");
這兩個是針對特定格式的捷徑,用法相同:把檔案載入並立即執行(getScript)或解析為物件(getJSON)。
$.getScript("js1.js"); // 載入 js 並自動執行
$.getJSON("demo.json", function (data) { /* ... */ });
用 $.each() 遍歷回傳的陣列,就能把資料渲染成清單。JSON 的格式相當嚴格,任何一個括號不匹配都會讓整段腳本停擺;若用字串拼接方式產生,務必確認輸出的每個引號與逗號都正確。
$.ajax(options)
所有上層方法到頭來都是呼叫它。參數是一個以 key/value 描述設定與回調的物件:
application/x-www-form-urlencoded。完整範例:
$.ajax({
type: "GET",
url: "demo.json",
dataType: "json",
success: function (data) {
$("#resText").empty();
var html = "";
$.each(data, function (i, comment) {
html += "<div class='comment'>" + comment['username'] + "</div>";
});
$("#resText").html(html);
},
error: function (xhr, textStatus, errorThrown) {
console.log(textStatus, errorThrown);
}
});
在回調中,this 會指向本次請求的 options 物件,需要時可直接取用其中的設定。
瀏覽器的同源政策會阻擋跨網域的 Ajax。變通做法有兩種:由伺服器端回應 Access-Control-Allow-Origin 標頭(CORS),或使用 JSONP——它利用 script 標籤不受同源限制的特性,把回應包成函式呼叫,缺點是只能發 GET,且無法 proper 處理錯誤狀態。另外別忘了,任何從伺服器取回的 HTML 若直接插入頁面,都應先確保內容可信,避免 XSS。