這份手冊把 jQuery 的 Ajax 支援整理成可查閱的型式,耐心看完基本就能入門。
透過一個 Ajax 請求取得遠端資料,prop 是一個 hash 表,可傳遞的 key/value 如下:
type(String):資料傳遞方式,get 或 post。url(String):請求頁面的網址。data(String):傳遞的參數字串,適合 post 方式。dataType(String):期待回傳的資料格式,例如 "xml"、"html"、"script" 或 "json"。ifModified(Boolean):僅在最後一次請求後內容有變化時才視為成功,預設 false。timeout(Number):設定請求逾時的毫秒數。global(Boolean):是否為本次請求觸發全域 Ajax 事件,預設 true。error(Function):請求失敗時觸發。success(Function):請求成功時觸發。complete(Function):請求完成後觸發。$.ajax({url: "ajax.htm",
success:function(msg){
$("div#a").html(msg);
}
});
把 ajax.htm 回傳的內容作為 id 為 a 的 div 內容。加上參數與型別後:
$.ajax({ url: "ajax.aspx",
type:"get",
dataType:"html",
data: "name=John&location=Boston",
success:function(msg){
$("#a").html(msg);
}
});
以 get 方式向 ajax.aspx 傳參數,並把回傳內容寫給 id 為 a 的元素。
設定全域的請求逾時時間。
$.ajaxTimeout( 5000 )
以 get 方式向遠端頁面傳遞參數,除了 url 之外,其餘參數皆可省略。
$.get( "ajax.htm" , function(data){ $("#a").html(data) })
$.get( "ajax.asp",
{ name: "young", age: "25" },
function(data){ alert("Data Loaded: " + data); }
)
$.getIfModified(url, params, callback)——以 get 傳參數,僅在資料有變動時才回應並執行 callback。$.getJSON(url, params, callback)——以 get 向遠端 JSON 物件傳參數,完成後執行 callback。$.getScript(url, callback)——以 get 載入並執行遠端 JavaScript 檔。$.post(url, params, callback)——以 post 向遠端頁面傳遞參數。load(url, params, callback)——載入遠端檔案並插入頁面 DOM,再執行 callback。loadIfModified(url, params, callback)——同上,但僅在資料有變動時才更新 DOM。$("#a").load("ajax.htm", function() { alert("load is done"); } );
向 ajax.htm 發出請求,把結果裝入 id 為 a 的內容,然後執行 callback。
ajaxStart(callback)——Ajax 請求開始時執行。ajaxComplete(callback)——請求完成時執行。ajaxError(callback)——請求發生錯誤時執行。ajaxStop(callback)——請求停止時執行。ajaxSuccess(callback)——請求成功時執行。這一組是處理全域 loading 指示器與錯誤提示的最佳位置,不必在每個請求裡重複寫。
隨著 jQuery 廣泛使用,社群累積了大量外掛,例如 thickbox、iFX、jQuery-googleMap 等,只要簡單引入檔案就能使用。以下幾個站點提供了豐富的 demo,即使英文不太行也能快速上手:
挑外掛時有兩個實務建議:優先選擇仍在維護、有清楚文件與 demo 的專案;引入前先確認它依賴的 jQuery 版本,避免版本衝突造成難以追蹤的錯誤。