jQuery 最鮮明的特色之一就是鏈式呼叫(chaining)。大多數 jQuery 方法都會回傳 jQuery 物件本身,因此可以一路串接下去,不必反覆指定同一個元素。
$second.html(value);
$second.on('click', function () { alert('hello everybody'); });
$second.fadeIn('slow');
$second.animate({ height: '120px' }, 500);
這裡每一行都用 $second 重新指定同一個元素。功能上完全正確,但同一個選擇器被重複書寫四次,程式碼冗長且顯得笨重。
$second.html(value)
.on('click', function () { alert('hello everybody'); })
.fadeIn('slow')
.animate({ height: '120px' }, 500);
一行串到底,元素只指定一次,意圖一目了然:對這個元素依序做四件事。
可讀性:程式碼讀起來像一句描述句——「設定內容、綁定點擊、淡入、然後放大高度」。
效能:每呼叫一次 $() 或選擇器,jQuery 都要走一遍 DOM 查詢。串起來之後只查詢一次,在複雜選擇器上差異明顯。
可維護性:日後要調整順序或插入新步驟,改動集中在同一處,不必在多行之間來回比對。
有時候你需要在中途取得原始的 jQuery 物件而非串接結果,這時有幾個工具:
// .end() 回到上一個未過濾的集合
$("ul")
.find("li")
.addClass("item")
.end() // 回到 $("ul")
.addClass("list");
// 想取得 DOM 元素而非 jQuery 物件,用中括號或 .get()
var el = $("#myDiv")[0]; // 原生 DOM 元素,此處鏈中斷
var el2 = $("#myDiv").get(0);
.end() 在搭配 find()、filter()、parent() 這類會產生新集合的方法時特別有用,可以讓你在同一個表達式中穿梭於不同層級而保持鏈的連續。
鏈式呼叫很美好,但並非所有情況都適合:
步驟很長時。串五六個以上,讀者得先在腦中追著回傳值跑一遍才知道最後結果是什麼。適度用中介變數反而清楚:
var $list = $("ul").find("li").filter(":visible");
$list.addClass("active");
$list.on("click", handleClick);
需要條件判斷時。鏈是線性的,一旦某步驟要依條件決定,硬塞 if 進去會很醜,這時拆開更好。
回呼中要使用外層變數時。過深的鏈加上巢狀回呼會讓縮排層次失控,除錯時堆疊追蹤也難讀。
鏈式呼叫並非 jQuery 專利,這個模式在許多函式庫中都能看到(D3、Lodash、 various ORM)。而在原生 JavaScript 中,ES6 之後新增的陣列方法大多也回傳新值以支援串接:
const result = [1, 2, 3, 4, 5]
.filter(n => n % 2 === 0)
.map(n => n * 10)
.reduce((sum, n) => sum + n, 0);
可見「回傳 self 或新物件以支援串接」是廣受採用的 API 設計慣例,jQuery 只是很早就把這個模式帶進主流的其中一員。