鏈式呼叫(chaining)是 jQuery 最具代表性的語法特色。它把多個操作串成一行,既縮短程式碼,也能實現一些用傳統寫法反而麻煩的效果。本文說明它的運作方式,以及兩個用來「回頭」的控制方法。
<script type="text/javascript">
$(function () {
$("div").addClass("css1").filter(function (index) {
return index == 1 || $(this).attr("id") == "fourth";
}).addClass("css2");
});
</script>
這段程式碼先為整個 div 列表加上 css1,接著進行篩選,再為篩選出的元素單獨加上 css2。若不使用 jQuery 鏈,需要用原生 DOM 寫出同等效果會繁瑣得多。
鏈之所以成立,關鍵在於 jQuery 的每個方法幾乎都會「回傳 jQuery 物件本身」,因此下一個方法可以繼續在這個物件上呼叫。而鏈中每個操作都以「上一步的結果」作為作用對象。
如果希望某個操作作用在上一步之前的對象,可以用 end():
<script type="text/javascript">
$(function () {
$("p").find("span").addClass("css1").end().addClass("css2");
});
</script>
<p>Hello,<span>how</span>are you?</p>
<span>very nice,</span>Thank you.
流程是這樣的:先在 p 中搜尋 span 並加上 css1,接著 end() 把作用對象退回成 $("p"),再為 p 加上 css2。於是 css1 只影響 span,css2 只影響 p,而頁面上那個不在 p 裡的 span 完全不受影響。
可以把它想成一個堆疊:每次改變集合就把前一個狀態壓入堆疊,end() 則是彈出。這讓你在同一條鏈裡自由穿梭於不同層級的集合,而不必重複寫選擇器。
另一個常見需求是「把前一步與這一步的結果一起處理」,這時用 andSelf():
<script type="text/javascript">
$(function () {
$("div").find("p").addClass("css1").andSelf().addClass("css2");
});
</script>
<div>
<p>第一段</p>
<p>第二段</p>
</div>
先在 div 中搜尋 p 並加上 css1(此時只有 p 受影響),再用 andSelf() 把 div 與 p 合成一個集合,加上 css2,於是 div 與 p 都套用了 css2。
結果的 DOM 會像這樣:
<div class="css2">
<p class="css1 css2">第一段</p>
<p class="css1 css2">第二段</p>
</div>
可以清楚看到:css1 只在 p 上,css2 則同時出現在 div 與 p。
鏈式寫法很優雅,但並非越長越好。當鏈超過三四個操作、或中間夾著條件判斷時,可讀性反而下降,此時拆成幾行、用變數保存中間結果會更好維護:
var $divs = $("div");
var $filtered = $divs.filter(".keep");
$divs.addClass("base");
$filtered.addClass("highlight");
另外要留意版本差異:andSelf() 在 jQuery 1.8 之後已更名為 addBack(),前者僅為相容而保留,新專案應使用 addBack()。兩者的差別細節在於 addBack 只納入堆疊中的前一個集合,語意更明確。
最後一個提醒:鏈中若某個方法回傳了非 jQuery 的值(例如 map() 搭配 get()),鏈就會中斷。若遇到「下一個方法不存在」的錯誤,通常就是這個原因,此時需要用 $() 重新包裝成 jQuery 物件才能繼續串接。