$.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 是在非同步的時機才執行。
如果目標 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。
其實 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)最耐操。核心觀念只有一個——回呼函式執行時已經離開原本的上下文了,必須事先把需要的資訊「帶進去」。