很多人分不清楚 $().each() 與 $.each() 的關係。其實前者只是把方法「委託」給後者,理解這層關係,就能掌握整個 each 家族。
jQuery 物件的 each 方法只是簡單地轉呼叫:
jQuery.prototype.each = function( fn, args ) {
return jQuery.each( this, fn, args );
}
也就是說:jQuery.each(obj, fn, arg) 針對傳入的物件中所有子元素逐一呼叫方法;而 jQuery 物件上的 .each() 則是把自己內部的元素交給它處理。
jQuery.each(obj, fn, args):
obj:要操作的物件fn:要執行的函式args:傳給 fn 的參數each 會對陣列中的每個元素逐一呼叫 fn,直到某個元素回傳 false 為止。也就是說,我們可以在 fn 中做條件判斷,滿足條件時就提早退出。
若提供了 args 參數,fn 被呼叫時傳入的就是 args;否則傳入的是「子元素索引」與「子元素本身」。
與上面最大的差別是:fn 會被逐次呼叫且不考慮回傳值。也就是說 obj 的所有屬性都會被 fn 處理一次,即使 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(args),而是 fn.call(val, i, val) 或 fn.apply(obj, args)。
這意味著:在你自己實作的 fn 中,可以直接用 this 參照到陣列或物件的當前子元素。這是絕大多數 jQuery 方法採用的實作方式,也是為什麼下面兩種寫法等效:
$.each(arr, function(i, val){
console.log(this === val); // true
});
$("div").each(function(){
$(this).css("color", "red"); // this 就是當前的 DOM 元素
});
最後補充一點:判斷是否中斷時,原始碼用的是嚴格比較 !== false,所以只有明確回傳布林值 false 才會停止,回傳 0、""、null 都不會中斷。這個細節在撰寫回呼時值得留意。