jQuery 把 Ajax 相關的 API 封裝得相當完整,從全域事件到語法糖應有盡有。先把清單列出來:
.ajaxComplete():請求完成時觸發。.ajaxError():請求失敗時觸發。.ajaxSend():請求即將送出時觸發。.ajaxStart():第一個請求開始時觸發。.ajaxStop():所有請求都結束時觸發。.ajaxSuccess():請求成功時觸發。.load():從伺服器載入資料,並用回傳的 HTML 取代符合選擇器的元素內容。jQuery.post():以 HTTP POST 載入伺服器資料。.serialize():把表單元素集編碼成可直接提交的查詢字串。.serializeArray():把表單元素集編碼成鍵值對陣列。jQuery.param():把陣列或物件序列化成適用於 URL 查詢字串或 Ajax 請求的字串。jQuery.getScript():載入並執行遠端 JavaScript 檔。jQuery.getJSON():載入 JSON 格式的資料。jQuery.get():以 GET 方式載入資料。<!DOCTYPE HTML>
<html>
<head>
<script type="text/javascript" src="test/jquery-1.7.2.min.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$('.log1').ajaxStart(function() {
$(this).text('Triggered ajaxStart handler.');
});
$('.log2').ajaxStop(function() {
$(this).text('Triggered ajaxStop handler.');
});
$('.trigger').click(function() {
$('.result').load('xixi.html');
});
});
</script>
</head>
<body>
<div class="trigger">Trigger</div>
<div class="result"></div>
<div class="log1"></div>
<div class="log2"></div>
</body>
</html>
這裡 class 為 result 的元素透過 load 載入了 xixi.html,檔案內容不拘,存在即可。執行順序是:先觸發 $(this).text('Triggered ajaxStart handler.'),接著把 xixi.html 的內容載入 result 元素,最後觸發 $(this).text('Triggered ajaxStop handler.')。
值得留意的是 ajaxStart 與 ajaxStop 的語意差異:ajaxStart 在「有請求開始」時觸發,ajaxStop 則要等到「所有進行中的請求都結束」才觸發。這個設計讓它非常適合做全域 loading 遮罩——同時發出五個請求,遮罩只會顯示一次、隱藏一次。
<!DOCTYPE HTML>
<html>
<head>
<script type="text/javascript" src="test/jquery-1.7.2.min.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$('.log1').ajaxStart(function() {
$(this).text('Triggered ajaxStart handler.');//【1】
});
$('.log2').ajaxStop(function() {
$(this).text('Triggered ajaxStart handler.');//【5】
});
$('.result').ajaxSend(function() {
$(this).text('Triggered ajaxSend handler.');//【2】
});
$('.result').ajaxComplete(function() {
$(this).text('Triggered ajaxComplete handler.');//【4】
});
$('.result').ajaxSuccess(function() {
$(this).text('Triggered ajaxSuccess handler.');//【3】
});
$(".result").ajaxError(function() {
$(this).text( "Triggered ajaxError handler." );
});
$('.trigger').click(function() {
$('.result').load('xixi.html');
});
});
</script>
</head>
<body>
<div class="trigger">Trigger</div>
<div class="result"></div>
<div class="log1"></div>
<div class="log2"></div>
</body>
</html>
一樣是 result 載入一個 HTML 檔,但這次把整組回呼都掛上,執行順序已在註解中標號:
如果過程中出錯——檔案不存在、回應碼異常、解析失敗——就會改走 ajaxError,而 ajaxSuccess 完全不會被觸發;ajaxComplete 則依然照跑。這也是實務上很實用的組合:ajaxSuccess 放成功後的業務邏輯,ajaxComplete 放需要無條件執行的清理工作(例如關閉 loading)。
過去我對 Ajax 的認識一直有點零散,這次把方法清單與觸發時序一起走過,總算有了完整的圖像。另外值得一提的是,究竟該用 HTTP GET 還是 POST,也是相當值得深入的一門功課——GET 適合冪等查詢、參數會暴露在 URL 上;POST 適合提交會改變伺服器狀態的資料,也不必受 URL 長度限制。