DIV CSS 佈局教程網

jQuery.map() 方法使用詳解:從用法到原始碼
編輯:關於JavaScript     

原型 map 與靜態 map 的關係

jQuery 的原型方法 map 其實是呼叫同名的靜態方法,再把結果交給 pushStack 處理後回傳:

 map: function( callback ) { return this.pushStack( jQuery.map(this, function( elem, i ) { return callback.call( elem, i, elem ); })); }, 

所以真正的邏輯都在靜態 $.map() 裡,pushStack 的部分留待下一篇再談。

基本用法

$.map() 的作用是「把一個陣列的元素轉換到另一個陣列中」。作為參數的轉換函式會為每個元素呼叫一次,並收到該元素作為參數。轉換函式可以回傳:轉換後的值、null(代表刪除該項),或一個陣列(會被展開併入原始陣列)。

簽章為 $.map(arrayOrObject, callback),第一個參數可以是陣列或物件。此外 callback 也能寫成字串形式的 lambda,例如 "a * a" 等同於 function(a){ return a * a; }。

 //將原數組中每個元素加 4 轉換為一個新數組。 //jQuery 代碼: $.map( [0,1,2], function(n){ return n + 4; }); //結果: [4, 5, 6] 
 //原數組中大於 0 的元素加 1 ,否則刪除。 //jQuery 代碼: $.map( [0,1,2], function(n){ return n > 0 ? n + 1 : null; }); //結果: [2, 3] 
 //原數組中每個元素擴展為一個包含其本身和其值加 1 的數組,並轉換為一個新數組 //jQuery 代碼: $.map( [0,1,2], function(n){ return [ n, n + 1 ]; }); //結果: [0, 1, 1, 2, 2, 3] 

map 與 each 的差異

兩者都是遍歷,但關鍵差別有三:

一是回傳值:each() 回傳原本的陣列,不會新建;map() 會建立一個新陣列,原陣列完全不動。

二是回調中的 this:each 的 this 指向目前的陣列元素或物件值;map 的 this 指向 window,因為它並沒有像 each 那樣用 call 進行「物件冒充」。

三是回傳值的意義:map 的回調回傳值會被收集起來,回傳 null 則會把該項過濾掉,這讓它特別適合做「轉換 + 篩選」一次完成。

 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] 

原始碼逐段拆解

 // 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 ); }, 

第一步:判斷是陣列還是物件。 那個看起來很長的 isArray 運算式,其實只是運算子優先順序造成的視覺壓力。括號先算,然後依序是邏輯與 > 邏輯或 > 全等 > 賦值,拆開來看就清楚了:isArray 為真必須滿足「elems 是 jQuery 物件」,或者「length 存在且為數字」加上三個子條件之一——length > 0 且首尾元素都存在(確保真的可遍歷,例如 jQuery 物件、DOM 集合)、length === 0(空集合也沒關係,就是不會進迴圈)、或者根本是純陣列。

第二步:分頭遍歷。 是陣列或類陣列就用 for 迴圈,把元素值、索引與內部參數 arg 一起傳進回調;是物件就用 for...in,傳入值與 key。兩邊都只在回傳值不為 null 時才把它推進結果陣列。

第三步:扁平化。

 // Flatten any nested arrays return ret.concat.apply( [], ret ); 

這一步之所以必要,是因為 map 允許回調回傳陣列來「擴充」元素,如前面第三個範例那樣。若不攤平,就會得到一個二維陣列。這裡 ret.concat.apply([], ret) 等價於 [].concat.apply([], ret),關鍵在 apply——它會把 ret 的元素拆成多個參數傳給 concat,於是二維就被降成一維。這個技巧相當值得收藏,遇到需要攤平巢狀陣列時可以直接套用。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved