jQuery 提供了一整組遍歷函數,用於篩選、查找與串聯元素。個別使用已經很方便,串起來用更是強大——一個函數的輸出可以直接成為下一個函數的輸入。以下先列出完整清單,再針對 each 做深入說明。
var arr = [ "one", "two", "three", "four"];
$.each(arr, function() {
alert(this);
}); // 依序輸出 one, two, three, four
var arr1 = [[1, 4, 3], [4, 6, 6], [7, 20, 9]];
$.each(arr1, function(i, item) {
alert(item[0]);
}); // 二維陣列,item 是每個一維陣列,item[0] 取第一個值 → 1 4 7
var obj = { one: 1, two: 2, three: 3, four: 4 };
$.each(obj, function(i) {
alert(obj[i]);
}); // 可遍歷每個屬性 → 1 2 3 4
$(document).ready(function() {
$("button").click(function() {
$("li").each(function() {
alert($(this).text());
});
});
});
點擊按鈕後會依序彈出 Coffee、Milk、Soda。
需求:取得所有核取方塊的 id。
用 each,自己宣告陣列並 push:
$(function() {
var arr = [];
$(":checkbox").each(function(index) {
arr.push(this.id);
});
var str = arr.join(",");
alert(str);
})
用 map,回傳值會自動被收集成 jQuery 物件:
$(function() {
var str = $(":checkbox").map(function() {
return this.id;
}).get().join();
alert(str);
})
需要把結果整理成陣列時,map 明顯更省事。
遍歷陣列,同時取得索引與值:
$.each([0, 1, 2], function(i, n) {
alert("Item #" + i + ": " + n);
});
遍歷物件,取得屬性名稱與值:
$.each({ name: "John", lang: "JS" }, function(i, n) {
alert("Name: " + i + ", Value: " + n);
});
遍歷 DOM 元素,以下以隱藏輸入框為例:
<input name="aaa" type="hidden" value="111" />
<input name="bbb" type="hidden" value="222" />
$.each($("input:hidden"), function(i, val) {
alert(val); // [object HTMLInputElement]
alert(i); // 索引 0, 1, 2...
alert(val.name); // name 屬性值
alert(val.value); // value 屬性值
});
效果:只有滑鼠移入時才顯示「回復」連結。
<div class="reply">
<p>嗨,第一層評論</p>
<div class="reply">
<a href="#" class="comment-reply-link">回復</a>
</div>
</div>
$("div.reply").hover(function() {
$(this).find(".comment-reply-link").show();
}, function() {
$(this).find(".comment-reply-link").hide();
});
另一個應用是驗證每題是否都有勾選:
$("ul#ulSingle > li.liStyle").each(function(index) {
var count = $(this).find("ul > li > :checkbox").length;
var selectedCount = 0;
for (var i = 0; i < count; i++) {
if ($(this).find("ul > li > :checkbox:eq(" + i + ")").attr("checked")) {
selectedCount++;
break;
}
}
if (selectedCount == 0) {
$(this).find("label#selectTips").show();
return false;
} else {
$(this).find("label#selectTips").hide();
}
})
jQuery.each(object, [callback]) 是通用的遍歷方法,可用於物件與陣列。有別於遍歷 jQuery 物件的 $().each(),它能處理任何物件。回呼函式有兩個參數:第一個是成員名稱或陣列索引,第二個是對應的值。若需要提前結束迴圈,讓回呼函式回傳 false 即可,其他回傳值會被忽略。
參數方面,object 是要遍歷的物件或陣列,callback 是每個成員/元素要執行的函式(可選)。