DIV CSS 佈局教程網

jQuery Ajax 完整整理:load、get、post 到 $.ajax
編輯:JQuery特效代碼     

jQuery 把 Ajax 操作做了分層封裝:最上層是 load、$.get、$.post、$.getScript、$.getJSON 這些好用的捷徑,最底層則是 $.ajax()。先從上層看起,最後再回頭理解底層。

load():直接把 HTML 塞進 DOM

load(url [, data] [, callback])
  • url:伺服器資源位址。
  • data:送往伺服器的一組 key/value 資料。
  • callback:請求完成後(不論成功失敗)呼叫,參數依序是回應文字、狀態碼與 xhr 物件。

最簡單的用法只要一行:

$("#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() 與 $.post()

$.get(url [, data] [, callback] [, type])
$.post(url [, data] [, callback] [, type])

四個參數分別是請求位址、以 key/value 組成的資料、成功時呼叫的函式,以及預期的回應格式。

兩者的差異在語意:GET 應該是「讀取」,多次呼叫結果一致,不改變伺服器狀態;POST 則用來「修改」,例如新增或刪除。實作上還有幾點實際影響:

  • GET 把參數接在 url 後,POST 放在 HTTP 訊息本文中。
  • GET 的資料量受限(一般 2KB 上下),POST 理論上不限。
  • GET 的回應可能被瀏覽器快取,必要時加時間戳避免拿到舊資料。

中文參數記得用 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)或解析為物件(getJSON)。

$.getScript("js1.js");           // 載入 js 並自動執行
$.getJSON("demo.json", function (data) { /* ... */ });

用 $.each() 遍歷回傳的陣列,就能把資料渲染成清單。JSON 的格式相當嚴格,任何一個括號不匹配都會讓整段腳本停擺;若用字串拼接方式產生,務必確認輸出的每個引號與逗號都正確。

$.ajax():最底層也最靈活

$.ajax(options)

所有上層方法到頭來都是呼叫它。參數是一個以 key/value 描述設定與回調的物件:

  • url:請求位址。
  • type:請求方法,預設 GET。
  • data:送往伺服器的資料,物件會自動轉成查詢字串。
  • dataType:預期回應型別,可為 xml、html、script、json、jsonp、text。不指定時 jQuery 會依 Content-Type 自行判斷。
  • complete:請求完成後呼叫(成功失敗都會),參數為 xhr 與狀態字串。
  • success:成功時呼叫,參數為處理後的資料與狀態字串。
  • error:失敗時呼叫,參數為 xhr、錯誤資訊與錯誤物件。
  • contentType:送出時的編碼型別,預設 application/x-www-form-urlencoded。
  • jsonp:自訂 JSONP 回調參數名稱。

完整範例:

$.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。

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