DIV CSS 佈局教程網

jQuery 進階技巧:如何為 AJAX 回呼函式傳入額外參數
編輯:JQuery特效代碼     

$.get()、$.post() 的回呼函式簽名是固定的 (data, textStatus, jqXHR),那如果我們需要把「當前是哪顆按鈕」、「要更新哪個容器」這類資訊也帶進回呼裡,該怎麼辦?以下用三個由淺入深的例子說明。

情境設定

希望點擊 button1 或 button2 之後,用 AJAX 取得 example.html 的內容,然後更新 id 為 callbackdemo3 的 div。

<div id="callbackdemo1">
  <button id="button1">ajax load1</button><br/>
</div>
<div id="callbackdemo2">
  <button id="button2">ajax load2</button><br/>
</div>
<div id="callbackdemo3" class="log"></div>
<button onclick="$('.log').html('');">clear</button>

做法一:直接在回呼裡重新選取(最直觀)

適用於最簡單的情況:目標元素有固定的 id,直接在回呼中選它即可。

$("#callbackdemo1 > #button1").click(
  function load(){
    $.get("example.html", { 'param[]': ["var1", "var2"] },
      function f1(data, textStatus, XMLHttpRequest)
      {
        $("#callbackdemo3").html(data);
      }
    );
  }
);

缺點很明顯:回呼與具體的 DOM 結構綁死了,同一段邏輯無法重用到不同目標上。

做法二:把額外參數當成函式參數傳進自訂回呼

先定義一個接受額外參數的回呼函式,再在 jQuery 的預設回呼中呼叫它。這樣就能保有各呼叫點的上下文。

function callback_with_extraParam(data, param)
{
  param.html(data);
}

$("#callbackdemo2 > #button2").click(
  function load(){
    var extraParam = $("#callbackdemo3");
    $.get("example.html", { 'param[]': ["var1", "var2"] },
      function f2(data)
      {
        callback_with_extraParam(data, extraParam);
      }
    );
  }
);

這裡的關鍵是閉包:extraParam 是 click 處理函式內的區域變數,而 f2 是在同一個作用域中定義的,因此它能取用這個變數,即使 f2 是在非同步的時機才執行。

做法三:用「我現在在哪裡」取代 id(最靈活)

如果目標 div 沒有 id 呢?看看這個稍微複雜的結構:

<div id="callback_complexdemo">
  <button id="button3">ajax load3</button><br/>
  <button onclick="$('div',$(this).closest('div')).html('');">clear</button><br/>
  <div></div>
</div>

要用 #callback_complexdemo > div 當然也行,但如果是更深、更複雜、甚至根本沒有 id 可依靠的頁面呢?這時就該善用上下文參數。

在 click 的處理函式中,先記下「我」是誰:

var whereAmI = $(this);     // 這是一個 jQuery 物件,代表被點擊的按鈕

然後在 AJAX 回呼中,從 whereAmI 出發去找目標:

$("#callback_complexdemo > #button3").click(
  function load(){
    var whereAmI = $(this);
    $.get("example.html", { 'param[]': ["var1", "var2"] },
      function f3(data)
      {
        console.log(whereAmI);
        $('div', $(whereAmI).closest('div')).html(data);
      }
    );
  }
);

最後那行新手常看不懂,拆成兩步就清楚了:

var $closest_parent_div = $(whereAmI).closest('div');   // 找到最近的父 div
$('div', $closest_parent_div);                          // 在該父 div 的範圍內找 div

closest() 會由目前元素往上一層一層找,直到符合選擇器為止;而 $("selector", context) 的第二個參數就是搜尋範圍。兩者合起來,等於說「從我出發,找我旁邊那個 div」,完全不需要依賴 id。

補充:更簡潔的 eventData 寫法

其實 jQuery 的事件綁定本身就支援傳入額外資料,不必繞道閉包:

$("#button1").on("click", { target: "#callbackdemo3" }, function(e){
  var $btn = $(this);
  $.get("example.html", function(data){
    $(e.data.target).html(data);
  });
});

on() 的第二個參數會被放進事件物件的 data 屬性,回呼中透過 e.data 取得。這種寫法語意更清楚,也不需要在每個回呼外再包一層自訂函式。

三種做法的取捨:結構簡單就用做法一;需要共用回呼邏輯就用做法二;結構不確定或元件化時,做法三(或 eventData)最耐操。核心觀念只有一個——回呼函式執行時已經離開原本的上下文了,必須事先把需要的資訊「帶進去」。

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