原型方法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.Array( elemsisArray( )這三個至少成立一個
可以拆分為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方法簡單分析完畢,能力有限錯誤之處望多多指正。
以上所述就是本文的全部內容了,希望大家能夠喜歡。