DIV CSS 佈局教程網

jQuery Ajax 全解析:從簡化方法到 $.ajax 底層參數
編輯:JQuery特效代碼     

廢話少說,直接進主題。先看幾個 jQuery 對 ajax() 做的封裝,日常開發八成場景用它們就夠了;如果邏輯比較複雜,還是得回到 $.ajax(),後面會談到。

1. load(url, [data], [callback])

載入遠端 HTML 並插入 DOM。

  • url(String):要請求的 HTML 頁面位址。
  • data(Map,可選):送往伺服器的 key/value 資料。
  • callback(Callback,可選):請求完成後的回呼函式,不限成功與否。

預設用 GET 傳遞;一旦傳入了 data,就會自動切成 POST。jQuery 1.2 起還支援選擇器語法,只把過濾出來的部分插入 DOM,寫法形如 "url #some > selector"。

$(".ajax.load").load("https://www.cnblogs.com/QLeelulu/archive/2008/03/30/1130270.html .post",
  function (responseText, textStatus, XMLHttpRequest) {
      this; // 這裡的 this 指向目前的 DOM 元素,即 $(".ajax.load")[0]
      // alert(responseText);  請求返回的內容
      // alert(textStatus);    請求狀態:success、error
      // alert(XMLHttpRequest); XMLHttpRequest 物件
  });

注意:寫絕對路徑時在 Firefox 下容易出錯;下面的 get() 與 post() 範例都是跨域呼叫,實際測試往往拿不回結果,因此我把執行按鈕移除了。

2. jQuery.get(url, [data], [callback])

  • url(String):請求位址。
  • data(Map,可選):以 key/value 表示的資料,會被附加成 QueryString。
  • callback(Function,可選):只有在回應狀態為 success 時才會被呼叫。
$.get("./Ajax.aspx", { Action: "get", Name: "lulu" }, function (data, textStatus) {
    // data 可以是 xmlDoc、jsonObj、html、text 等
    this; // 這裡的 this 指向這次 Ajax 請求的設定資訊
    alert(data);
    // alert(textStatus); 注意:出錯時根本不會進入這個回呼函式
});

3. jQuery.post(url, [data], [callback], [type])

  • url(String):請求位址。
  • data(Map,可選):送往伺服器的 key/value 資料。
  • callback(Function,可選):成功時的回呼函式。
  • type(String,可選):官方文件寫的是「要送出的資料型別」,實際上應該理解為用戶端期望的**回應**型別,例如 json、xml。
// Ajax.aspx
Response.ContentType = "application/json";
Response.Write("{result: '" + Request["Name"] + ",你好!(這則訊息來自伺服器)'}");

// jQuery
$.post("Ajax.aspx", { Action: "post", Name: "lulu" },
  function (data, textStatus) {
      alert(data.result);
  }, "json");

這裡有個容易踩的坑:如果你把 type 設為 "json",卻沒有同步把伺服器的 Response.ContentType 設成 application/json,就會拿不到資料。另外因為 Accept 標頭已宣告為 json,回傳的 data 本身就是物件,不需要再用 eval() 轉換。

4. jQuery.getScript(url, [callback])

用 GET 方式載入並執行一支 JavaScript 檔。

  • url(String):待載入的 JS 位址。
  • callback(Function,可選):載入成功後的回呼函式。

1.2 版之前只能呼叫同域的 JS,1.2 之後開放跨域。要留意 Safari 2 或更早版本無法在全域作用域中同步執行腳本,若用 getScript 動態加入腳本,記得加上延遲。

$.getScript("test.js");

$.getScript("AjaxEvent.js", function () {
    alert("AjaxEvent.js 已載入並執行完成。");
});

典型用途是延遲載入:例如只在編輯器取得焦點時,才去下載它需要的 JS 檔。

jQuery Ajax 事件

Ajax 請求會觸發一系列事件,可以訂閱它們來插入自己的邏輯。jQuery 把事件分成兩類:

局部事件是在每次請求的設定中個別定義的:

$.ajax({
    beforeSend: function () {
        // 處理 beforeSend
    },
    complete: function () {
        // 處理 complete
    }
    // ...
});

全域事件則是每次請求都會觸發,並向 DOM 中所有元素廣播:

$("#loading").bind("ajaxSend", function () {
    $(this).show();
}).bind("ajaxComplete", function () {
    $(this).hide();
});

// 或者
$("#loading").ajaxStart(function () {
    $(this).show();
});

若想在某次請求中關掉全域事件,把 global 設為 false 即可:

$.ajax({
    url: "test.html",
    global: false, // 停用全域 Ajax 事件
    // ...
});

官方完整的 Ajax 事件清單:

  • ajaxStart(全域):當 Ajax 請求啟動、且沒有其他請求正在執行時廣播。
  • beforeSend(局部):請求送出前觸發,可修改 XMLHttpRequest 物件,例如加上自訂標頭。
  • ajaxSend(全域):同樣在請求執行前觸發的全域版本。
  • success(局部):僅在請求成功時呼叫。
  • ajaxSuccess(全域):成功時觸發的全域版本。
  • error(局部):僅在請求失敗時呼叫,與 success 互斥。
  • ajaxError(全域):行為等同局部的 error。
  • complete(局部):不論成功或失敗都會呼叫,同步請求亦然。
  • ajaxComplete(全域):每次 Ajax 請求結束都會觸發。
  • ajaxStop(全域):當再沒有 Ajax 請求在處理時觸發。

jQuery.ajax(options):功能最強的底層方法

這是 jQuery 的底層 AJAX 實作,$.get、$.post 都是它的高階封裝。它會回傳自己建立的 XMLHttpRequest 物件,一般情況不需要直接操作,但特殊場景下可以用來手動中止請求。

注意:如果指定了 dataType,請確認伺服器回傳正確的 MIME 型別(例如 xml 要回 text/xml),錯誤的 MIME 可能造成難以預料的行為。另外,當 dataType 設為 script 時,所有跨域的 POST 請求都會被轉為 GET。

參數一覽

參數型別說明
urlString預設為目前頁位址,請求的目標網址。
typeString預設 "GET",可設 "POST"。其他如 PUT、DELETE 也可使用,但僅部分瀏覽器支援。
timeoutNumber請求逾時時間(毫秒),會覆蓋全域設定。
asyncBoolean預設 true 為非同步。設為 false 則同步,但會鎖住瀏覽器,使用者其他操作必須等請求結束。
beforeSendFunction送出前可修改 XMLHttpRequest 的函式,唯一參數為該物件。
function (XMLHttpRequest) { this; }
cacheBooleanjQuery 1.2 新增,預設 true;設為 false 則不從瀏覽器快取讀取。
completeFunction請求結束後(不論成敗)呼叫,參數為 XMLHttpRequest 與狀態字串。
contentTypeString預設 "application/x-www-form-urlencoded",送往伺服器時的內容編碼型別,預設值適用多數場景。
dataObject / String送往伺服器的資料,會自動轉為請求字串;GET 時附加在網址後。若為陣列,jQuery 會自動用相同名稱對應多個值,如 {foo:["bar1","bar2"]} 轉為 &foo=bar1&foo=bar2。
dataTypeString預期回應型別:xml、html、script、json、jsonp。不指定時 jQuery 會依 HTTP 標頭的 MIME 自動判斷。
其中 jsonp 會自動把 ? 替換成正確的函式名以執行回呼。
errorFunction請求失敗時呼叫,參數為 XMLHttpRequest、狀態字串、錯誤物件(通常兩者只有一個有值)。
globalBoolean預設 true,是否觸發全域 Ajax 事件;設 false 則 ajaxStart、ajaxStop 等都不會觸發。
ifModifiedBoolean預設 false;設 true 時僅在伺服器資料有變動才取新資料,靠 Last-Modified 標頭判斷。
processDataBoolean預設 true,會把資料轉為符合 application/x-www-form-urlencoded 的格式。若要送出 DOM 樹或其他不需轉換的內容,請設為 false。
successFunction成功後呼叫,參數為伺服器回傳的資料與狀態字串。

其中 beforeSend、success、complete、error 這四個回呼參數最能派上用場,用來精細控制每一次請求。要留意的是,這些回呼裡的 this 都指向該次請求的設定物件。若打算用 jQuery 做 Ajax 開發,上面這張表值得反覆看熟。

實作範例:抓取某部落格首頁的文章標題

$.ajax({
    type: "get",
    url: "https://www.cnblogs.com/rss",
    beforeSend: function (XMLHttpRequest) {
        // ShowLoading();
    },
    success: function (data, textStatus) {
        $(".ajax.ajaxResult").html("");
        $("item", data).each(function (i, domEle) {
            $(".ajax.ajaxResult").append("<li>" + $(domEle).children("title").text() + "</li>");
        });
    },
    complete: function (XMLHttpRequest, textStatus) {
        // HideLoading();
    },
    error: function () {
        // 請求出錯的處理
    }
});

其他輔助方法

jQuery.ajaxSetup(options):設定全域的 Ajax 預設值。

$.ajaxSetup({
    url: "/xmlhttp/",
    global: false,
    type: "POST"
});

$.ajax({ data: myData });

serialize() 與 serializeArray():前者把表單內容序列化成字串,後者回傳 JSON 結構的資料。

<p id="results"><b>Results: </b></p>
<form>
  <select name="single">
    <option>Single</option>
    <option>Single2</option>
  </select>
  <select name="multiple" multiple="multiple">
    <option selected="selected">Multiple</option>
    <option>Multiple2</option>
    <option selected="selected">Multiple3</option>
  </select><br/>
  <input type="checkbox" name="check" value="check1" /> check1
  <input type="checkbox" name="check" value="check2" checked="checked" /> check2
  <input type="radio" name="radio" value="radio1" checked="checked" /> radio1
  <input type="radio" name="radio" value="radio2" /> radio2
</form>

serialize() 的輸出結果:

serializeArray() 的輸出結果:

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