原型方法map跟each類似調用的是同名靜態方法,只不過返回來的數據必須經過另一個原型方法pushStack方法處理之後才返回,源碼如下:
map: function( callback ) {
return this.pushStack( jQuery.map(this, function( elem, i ) {
return callback.call( elem, i, elem );
}));
},
本文主要就是分析靜態map方法至於pushStack在下一篇隨筆裡面分析;
首先了解下map的使用(手冊內容)
$.map將一個數組中的元素轉換到另一個數組中。
作為參數的轉換函數會為每個數組元素調用,而且會給這個轉換函數傳遞一個表示被轉換的元素作為參數。
轉換函數可以返回轉換後的值、null(刪除數組中的項目)或一個包含值的數組,並擴展至原始數組中。
參數
arrayOrObject,callbackArray/Object,FunctionV1.6
arrayOrObject:數組或者對象。
為每個數組元素調用,而且會給這個轉換函數傳遞一個表示被轉換的元素作為參數。
函數可返回任何值。
另外,此函數可設置為一個字符串,當設置為字符串時,將視為“lambda-form”(縮寫形式?),其中 a 代表數組元素。
如“a * a”代表“function(a){ return a * a; }”。
示例1:
//將原數組中每個元素加 4 轉換為一個新數組。
//jQuery 代碼:
$.map( [0,1,2], function(n){
return n + 4;
});
//結果:
[4, 5, 6]
示例2:
//原數組中大於 0 的元素加 1 ,否則刪除。
//jQuery 代碼:
$.map( [0,1,2], function(n){
return n > 0 ? n + 1 : null;
});
//結果:
[2, 3]
示例3:
//原數組中每個元素擴展為一個包含其本身和其值加 1 的數組,並轉換為一個新數組
//jQuery 代碼:
$.map( [0,1,2], function(n){
return [ n, n + 1 ];
});
//結果:
[0, 1, 1, 2, 2, 3]
可以看出map方法跟each方法類似通過循環每個對象或者數組的“項”執行回調函數來實現對數組或者對象的操作,但是這兩個方法也有很多不同點
比如each()返回的是原來的數組,並不會新創建一個數組,而map則會創建新的數組,;each遍歷是this指向當前數組或對象值,map則指向window,因為在源碼中並不像each那樣使用對象冒充;
例如:
var items = [1,2,3,4];
$.each(items, function() {
alert('this is ' + this);
});
var newItems = $.map(items, function(i) {
return i + 1;
});
// newItems is [2,3,4,5]
//使用each時,改變的還是原來的items數組,而使用map時,不改變items,只是新建一個新的數組。
var items = [0,1,2,3,4,5,6,7,8,9];
var itemsLessThanEqualFive = $.map(items, function(i) {
// removes all items > 5
if (i > 5)
return null;
return i;
});
// itemsLessThanEqualFive = [0,1,2,3,4,5]
言歸正傳回到map源碼
// arg is for internal usage only
map: function( elems, callback, arg ) {
var value, key, ret = [],
i = 0,
length = elems.length,
// jquery objects are treated as arrays
isArray = elems instanceof jQuery || length !== undefined && typeof length === "number" && ( ( length > 0 && elems[ 0 ] && elems[ length -1 ] ) || length === 0 || jQuery.isArray( elems ) ) ;
// Go through the array, translating each of the items to their
if ( isArray ) {
for ( ; i < length; i++ ) {
value = callback( elems[ i ], i, arg );
if ( value != null ) {
ret[ ret.length ] = value;
}
}
// Go through every key on the object,
} else {
for ( key in elems ) {
value = callback( elems[ key ], key, arg );
if ( value != null ) {
ret[ ret.length ] = value;
}
}
}
// Flatten any nested arrays
return ret.concat.apply( [], ret );
},
首先還是聲明幾個變量為接下來的遍歷做准備,其中jsArray變量用來簡單區分對象和數組,這個布爾復合表達式比較長不過只要記住js運算符的有優先順序就不難理解了,首先括號優先執行然後就是邏輯與》邏輯或》全等》賦值,然後就可以分析啦
首先圓括號裡先計算然後結果加上 length !== undefined 、 typeof length === "number這兩個必要條件最後的結果再跟elems instanceof jQuery進行邏輯或的運算,簡單的說就是isArray為真的情況有:
1、elems instanceof jQuery 為true 換言之就是jquery對象
2、length !== undefined && typeof length === "number" 和 length > 0 && elems[ 0 ] && elems[ length -1 ] ) || length === 0 || jQuery.isArray( elems )這三個至少成立一個
可以拆分為3個小情況
length是存在並且是數字而且待遍歷的數組或者類數組等length屬性大於0 length-1存在 這樣就保證了是能遍歷的,比如對於jquery對象 domList對象等
length是存在並且是數字而且length屬性等於0 如果是0也沒關系就是不會遍歷
length是存在並且是數字而且待遍歷對象是純數組
滿足這些條件之後開始根據isArray的結果分開遍歷,對於“數組”采用for循環,對於對象采用for...in循環
// Go through the array, translating each of the items to their
if ( isArray ) {
for ( ; i < length; i++ ) {
value = callback( elems[ i ], i, arg );
if ( value != null ) {
ret[ ret.length ] = value;
}
}
是數組或者類數組的時候直接把循環的每一項的值和指針以及arg參數傳入回調函數中執行,arg參數是此方法內部使用的參數,跟each以及一些其他jquery方法很相似,只要在執行回調函數時不返回null就把執行返回的結果添加到新數組中,對象操作亦是如此直接略過
// Flatten any nested arrays
return ret.concat.apply( [], ret );
最後將結果集扁平化,為什麼有這一步呢?因為map是可以擴展數組的在前面第3個示例就是如此:
$.map( [0,1,2], function(n){
return [ n, n + 1 ];
});
如果是這樣使用的話得到的新數組是一個二維數組,所以必須降維
ret.concat.apply( [], ret )等價於[].concat.apply([],ret)關鍵作用的是apply,因為apply的第二個參數把ret的數組分成多個參數傳入給concat把二維數組轉化為一維數組這個用法還是值得收藏的的
map方法簡單分析完畢,能力有限錯誤之處望多多指正。
以上所述就是本文的全部內容了,希望大家能夠喜歡。