each 是 jQuery 裡最常被使用的方法之一,但它對不同型別的參數會有不同行為。下面用幾個例子把這些差異說清楚。
var arr1 = [ "one", "two", "three", "four", "five" ];
$.each(arr1, function(){
alert(this);
});
// 輸出:one two three four five
不宣告參數時,用 this 就能取得當前元素。
var arr2 = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]
$.each(arr2, function(i, item){
alert(item[0]);
});
// 輸出:1 4 7
參數名稱可以自己定義,each 會依第一個參數的格式來判斷回呼函式該怎麼呼叫。這裡 item 是每一個一維陣列,item[0] 就是該陣列的第一個值。
var obj = { one:1, two:2, three:3, four:4, five:5 };
$.each(obj, function(key, val) {
alert(obj[key]);
});
// 輸出:1 2 3 4 5
傳入物件時,回呼函式的兩個參數分別是「屬性名稱」與「屬性值」,這是 each 能遍歷物件所有屬性的原因。
$.each($("input:hidden"), function(){
alert(this.name);
});
$.each($("input:hidden"), function(){
alert(this.value);
});
包裝集本質上類似陣列,所以用法與陣列相同。不過這種情況更常直接寫成 $("input:hidden").each(...),效果一樣。
$(document).ready(function test() {
var arr1 = [[1, 4, 3], [4, 6, 6], [7, 20, 9]]
$.each(arr1, function(i, item){
if (i == 1) {
alert("點擊繼續下次遍歷");
return; // 相當於 continue,跳過這一輪
// return false; // 則是直接跳出整個遍歷
}
alert('索引' + i + '_' + item[0]);
});
})
這是 each 最需要記住的一條規則:回傳 false 中止整個迴圈,回傳其他任何值(包含 undefined)都相當於 continue,繼續下一輪。這和原生 for 迴圈的 break / continue 對應,但語法上是靠回傳值表達,一開始很容易搞混。
each 內部是用 fn.call(val, i, val) 這種形式呼叫回呼函式,而非單純的 fn(i, val)。差別在於:用 call 指定了 this 的指向,所以函式體內可以直接用 this 引用當前元素,不必另外宣告參數。這是 jQuery 中相當普遍的手法,理解它之後,看到別的原始碼裡到處出現的 this 就不會困惑了。