当前位置: 首页 > 中文手册 > jQuery.map() 函数详解

jQuery.map() 函数详解

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

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

语法

jQuery 1.2 新增该函数。

jQueryObject.map( callback )

参数

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

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

每次执行callback函数的返回值将作为结果数组中的一个元素,如果函数的返回值为nullundefined,则不会被添加到结果数组中。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

运行代码

48 2
我们认为: 用户的主要目的,是为了获取有用的信息,而不是来点击广告的。因此本站将竭力做好内容,并将广告和内容进行分离,确保所有广告不会影响到用户的正常阅读体验。用户仅凭个人意愿和兴趣爱好点击广告。
我们坚信:只有给用户带来价值,用户才会给我们以回报。
CodePlayer技术交流群1CodePlayer技术交流群1

帮朋友打一个硬广告:

P2P网贷系统(Java版本) 新年低价大促销,多年P2P技术积累,系统功能完善(可按需定制,可支持第三方存管、银行存管),架构稳定灵活、性能优异、二次开发快速简单。 另可提供二次开发、安装部署、售后维护、安全培训等一条龙服务。

外行看热闹,内行看门道。可以自信地认为,在系统设计上,比市面上的晓风、迪蒙、方维、绿麻雀、国融信、金和盛等P2P系统要好。
深圳地区支持自带技术人员现场考察源代码、了解主要技术架构,货比三家,再决定是否购买。

也可推荐他人购买,一旦完全成交,推荐人可获得实际售价 10% 的返现。
有意向者,详情请 点击这里 联系,工作时间立即回复。