DIV CSS 佈局教程網

jQuery AJAX 深入:$.post 與 $.ajax 的用法與事件
編輯:JQuery特效代碼     

jQuery 提供了三層 AJAX 封裝:$.load() 最簡單,$.get()/$.post() 是常用的中高層,而 $.ajax() 則是底層實作,所有其他方法最終都呼叫它。搞懂這三者的關係,就能依需求挑選合適的工具。

$.post 的簽章

jQuery.post( url, [data], [callback], [type] )
  • url (String):請求的目標位址。
  • data (Map,可選):要送到伺服器的資料,以 key/value 形式表示。
  • callback (Function,可選):載入成功時的回呼,只有當回應狀態為 success 才會被呼叫。
  • type (String,可選):期望的資料型別,如 json、xml、html、text。

$.post 適合取代繁瑣的 $.ajax 進行簡單的 POST 請求。但要注意:它沒有 error 回呼,若你需要處理失敗情況,就得改用 $.ajax。

$.post 實例

伺服器端(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:底層全控制

$.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 的價值

範例中 timeout: 1000 值得特別一提。若不設定,當伺服器無回應時請求會一直掛著,畫面上的 loading 也就永遠不停。設定逾時後,超時會走進 error 分支,讓你能給使用者明確的錯誤提示並重試。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved