寫 jQuery 之前,先把「集合」這個概念搞清楚,後面幾乎所有 API 都會順很多。jQuery 物件本身就是一個包裹了零到多個 DOM 元素的陣列,底下這幾個方法就是圍繞這個事實設計的。
以每一個匹配元素作為 this 執行傳入的函式。也就是說每次執行時,this 都指向不同的 DOM 元素;同時函式會收到一個從 0 開始的索引參數。
回傳 false 等於 break,直接中止整個迴圈;回傳 true 等於 continue,跳到下一項。
// 注意:這裡的 this 是 DOM 物件,不是 jQuery 物件
$("img").each(function (i) {
this.src = "test" + i + ".jpg";
});
// 需要 jQuery 物件時用 $(this) 包一層
$("img").each(function () {
$(this).toggleClass("example");
});
提前跳出:
$("button").click(function () {
$("div").each(function (index, domEle) {
$(domEle).css("backgroundColor", "yellow");
if ($(this).is("#stop")) {
$("span").text("Stopped at div index #" + index);
return false; // 中止
}
});
});
兩者回傳的值完全相同,size() 是方法、length 是屬性。寫 .length 少一對括號,效能上也好一點。
$("img").size(); // 2
$("img").length; // 2
get() 回傳所有匹配元素的原生陣列,get(index) 回傳單一元素。當你想用原生 DOM API(例如 reverse())而不是 jQuery 方法時就靠它。而 $(this).get(0) 與 $(this)[0] 完全等價。
$("img").get().reverse(); // [ <img src="test2.jpg"/> <img src="test1.jpg"/> ]
$("img").get(0); // [ <img src="test1.jpg"/> ]
在當前集合裡搜尋指定元素,找到就回傳從 0 開始的索引,找不到回傳 -1。
<div id="foobar"><b></b><span id="foo"></span></div>
$("*").index($('#foobar')[0]); // 5
把這幾個方法記熟,之後寫外掛、做 DOM 遍歷都會用到:each 負責迭代、length 負責判空、get 負責下降到原生層、index 負責定位。