jQuery.map() 函数详解

map()函数用于处理当前jQuery对象匹配的所有元素，并将处理结果封装为新的数组。返回封装该数组的jQuery对象。

该函数属于jQuery对象(实例)。

语法

jQuery 1.2 新增该函数。

jQueryObject.map( callback )

参数

参数描述callbackFunction类型指定的处理函数。

map()函数将根据匹配的所有元素遍历执行该函数，函数中的this将指向当前迭代的元素。map()还会为函数传入两个参数：第一个参数就是该元素在匹配元素中的索引，第二个参数就是该元素。

每次执行callback函数的返回值将作为结果数组中的一个元素，如果函数的返回值为null或undefined，则不会被添加到结果数组中。map()函数的返回值就是封装该结果数组的jQuery对象。

返回值

map()函数的返回值为jQuery类型，返回封装指定函数执行结果的数组的jQuery对象。

一般通过get()方法来获取jQuery对象中封装的整个数组或数组的某个元素。

示例&说明

以下面这段HTML代码为例：

<input id="n1" name="uid" type="checkbox" checked="checked" value="1"><input id="n2" name="uid" type="checkbox" checked="checked" value="2"><input id="n3" name="uid" type="checkbox" value="3"><input id="n4" name="uid" type="checkbox" checked="checked" value="4">

以下jQuery示例代码用于演示map()函数的具体用法：

var $checkedUid = $("[name=uid]:checked");// 将所有匹配元素的value值封装为结果数组，并返回封装了这个结果数组的jQuery对象var $result = $checkedUid.map( function(index, element){    // 函数内部的this === element    return this.value;  } );// 输出封装的结果数组中索引为1的元素document.writeln( $result.get( 1 ) ); // 2// 获取封装的整个结果数组var array = $result.get();document.writeln( array ); // 1,2,4

jquery中的each函数和map函数的用法看起来差不多，但其实还是有一点区别的。
其中一个重要的区别是，each返回的是原来的数组，并不会新创建一个数组。而map方法会返回一个新的数组。如果在没有必要的情况下使用map，则有可能造成内存浪费。
例如：
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]
当需要对数组进行删除时也是如此，所以删除时错误使用each或map后果还是蛮严重的。