初學 jQuery 時,最讓人頭暈的莫過於 each 有三種長相:$("img").each()、$.each(),以及在自寫外掛裡出現的 this.each()。它們看起來相似,其實分工完全不同,搞混之後常會出現「this 到底是什麼」的困惑。
這是最常見的用法,用來遍歷某個選擇器選到的所有元素。回呼函數會收到兩個參數:索引與目前的 DOM 元素。
$("img").each(function (i, elem) {
// i 是索引,從 0 開始
// elem 等同於 this,指向目前的 DOM 元素
// 若要當 jQuery 物件操作,需重新包裝一次
$(elem).toggleClass("example");
$(this).toggleClass("example");
});
關鍵點在這裡:在 each 的回呼裡,this 是原生 DOM 元素,不是 jQuery 物件。所以想用 jQuery 的方法,就得寫 $(this)。
$.each 是挂在 jQuery 命名空間上的工具函數,可以直接遍歷陣列或物件,不必先包裝成 jQuery 物件。
$.each([1, 2, 3, 4], function () {
// $(this) 就是陣列中的每一個元素
// 如果傳入的是物件,$(this) 就是該物件的每個值
});
這一種其實不是新東西,只是使用場景不同。當你在撰寫 jQuery 外掛、擴充 jQuery 物件方法時,函數內的 this 就是呼叫者本身,也就是一個 jQuery 物件,因此可以再接 each。
jQuery.fn.Fun = function () {
// 這裡的 this === $("img")
// 若呼叫者是別的選擇器,就是別的物件
this.each(function () {
// 這裡的 $(this) 才是單一的 DOM 元素
// $(this) === $("img")[0]
// $(this) === $("img")[1]
// ...
});
};
// 呼叫方式
$("img").Fun();
把三者的關係記成一句話:$.each 是萬用工具函數,$(集合).each 遍歷 DOM 集合,而 this.each 是你在外掛裡對呼叫者集合做遍歷時的起點。三層 this 的意義各不相同,釐清之後寫外掛就順手多了。