jQuery 提供了三層 AJAX 封裝:$.load() 最簡單,$.get()/$.post() 是常用的中高層,而 $.ajax() 則是底層實作,所有其他方法最終都呼叫它。搞懂這三者的關係,就能依需求挑選合適的工具。
jQuery.post( url, [data], [callback], [type] )
json、xml、html、text。$.post 適合取代繁瑣的 $.ajax 進行簡單的 POST 請求。但要注意:它沒有 error 回呼,若你需要處理失敗情況,就得改用 $.ajax。
伺服器端(Ajax.aspx):
Response.ContentType = "application/json";
Response.Write("{result: '" + Request["Name"] + ",你好!(這消息來自服務器)'}");
前端:
$.post("Ajax.aspx",
{ Action: "post", Name: "lulu" },
function (data, textStatus){
// data 依 dataType 而異,可能是 xmlDoc、jsonObj、html 或純文字
// this 指向這次 Ajax 請求的設定物件
alert(data.result);
},
"json");
把 type 設為 "json" 後,jQuery 會自動把回應字串解析成物件,於是可以直接 data.result 取值,不必自己 eval 或 JSON.parse。
$.ajax({
url: 'stat.php',
type: 'POST',
data: { Name: "keyun" },
dataType: 'html',
timeout: 1000,
beforeSend: function(){ /* 送出前,常用來顯示 loading */ },
error: function(){ alert('Error loading PHP document'); },
success: function(result){ alert(result); },
complete: function(){ /* 不論成功失敗都會執行,常用來收尾 */ }
});
beforeSend:請求送出前觸發。可在此取消請求(return false)或顯示等待動畫。success:請求成功且回應符合 dataType 時觸發,第一個參數是解析後的資料。error:請求失敗時觸發,包含逾時、HTTP 錯誤與解析失敗。complete:無論成功或失敗都會執行,適合放收尾工作,例如隱藏 loading 圖示。把 loading 的顯示放進 beforeSend、隱藏放進 complete,是一組很實用的搭配——因為 complete 在兩條路徑上都會跑到,不會出現失敗後轉圈不停的情形。
範例中 timeout: 1000 值得特別一提。若不設定,當伺服器無回應時請求會一直掛著,畫面上的 loading 也就永遠不停。設定逾時後,超時會走進 error 分支,讓你能給使用者明確的錯誤提示並重試。