each() 幾乎是所有框架都會提供的工具函式,用來遍歷物件或陣列的屬性並逐一處理。jQuery 物件與 jQuery 本身都實作了這個方法——對 jQuery 物件而言,它只是把 each 簡單地委託出去:把自己當成第一個參數傳給 jQuery.each()。
換句話說,jQuery 提供的 each() 是對傳入物件的所有子元素逐一呼叫方法;而 jQuery 物件的 each() 則是對它內部的元素逐個呼叫。
jQuery.prototype.each = function (fn, args) {
return jQuery.each(this, fn, args);
};
jQuery.each(obj, fn, args) 有三個參數:要操作的物件 obj、要執行的函式 fn、以及傳給 fn 的參數 args。依 obj 的型別,行為分成兩種:
1. obj 是陣列——會對每個子元素呼叫 fn,直到某次呼叫回傳 false 為止。也就是說,可以在 fn 裡做條件判斷來提早結束迴圈。若提供了 args,fn 收到的參數就是 args;否則是「子元素索引、子元素本身」。
2. obj 不是陣列——與上者的最大差異是:fn 會被逐次呼叫,而且**不考慮回傳值**,也就是即使回傳 false 也不會中斷,所有屬性都會被處理一遍。
jQuery.each = function (obj, fn, args) {
if (args) {
if (obj.length == undefined) {
for (var i in obj) fn.apply(obj, args);
} else {
for (var i = 0, ol = obj.length; i < ol; i++) {
if (fn.apply(obj, args) === false) break;
}
}
} else {
if (obj.length == undefined) {
for (var i in obj) fn.call(obj, i, obj);
} else {
for (var i = 0, ol = obj.length, val = obj[0];
i < ol && fn.call(val, i, val) !== false; val = obj[++i]) {}
}
}
return obj;
};
要特別注意的是,fn 並不是用簡單的 fn(i, val) 呼叫,而是採用 fn.call(val, i, val) 或 fn.apply(obj, args)。這意味著在自己的 fn 實作裡,可以直接用 this 參照到陣列或物件的子元素。這是 jQuery 內部相當常見的寫法。
一個常見應用是表單送出前的批次檢查:
$("#submit").click(function () {
try {
$('#leftTbl tr').each(function (i) {
var emailInput = $("#email_" + (1 + i));
if (!re.test(emailInput.val())) {
alert("請正確填寫 email");
emailInput.focus();
throw emailInput;
} else {
email = emailInput.val();
}
});
} catch (e) {
return false;
}
$("#pageform").submit();
});
這裡用 throw/catch 來中斷迴圈,也可以用計數器累加之後再判斷,兩種都行。
$('input').each(function () {
if ($(this).val() == '') {
// do something
if (1 == 1) return false; // return false 等同 break,跳出迴圈
else return true; // return true 等同 continue,進入下一輪
}
});
原理很簡單:jQuery 迭代每個元素後檢查回傳值,以此決定是否繼續下一輪。
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]);
});
// arr1 是二維陣列,item 代表每個一維陣列,item[0] 取其第一個值
// 輸出:1、4、7
var obj = { one: 1, two: 2, three: 3, four: 4 };
$.each(obj, function (key, val) {
alert(obj[key]);
});
// 這招更強,能逐一走訪物件的每個屬性
// 輸出:1、2、3、4