CodePlayer

eq()函数用于获取当前jQuery对象所匹配的元素中指定索引的元素，并返回封装该元素的jQuery对象。

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

语法

jQuery 1.1.2 新增该函数。

jQueryObject.eq( index )

参数

jQuery 1.4 新增支持：参数index可以为负数。如果index为负数，则将其视作length + index，这里的length指的是匹配到的元素的个数(负数的index也可理解为从后往前计数)。

返回值

eq()函数的返回值为jQuery类型，返回封装了指定索引index处的元素的jQuery对象。

如果索引值超出有效范围，则返回空的jQuery对象。

示例&说明

eq()函数与:eq()选择器具有如下等价代码：

$( "selector" ).eq( index );
//等价于
$( "selector:eq(index)" );

以下面这段HTML代码为例：

<div id="n1">
	<div id="n2">
		<ul id="n3">
			<li id="n4">item1</li>
			<li id="n5">item2</li>
			<li id="n6">item3</li>
		</ul>
	</div>
	<div id="n7">
		<ul id="n8">
			<li id="n9">item1</li>
			<li id="n10">item2</li>
		</ul>
	</div>
</div>

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

// 匹配n4、n5、n6、n9、n10这5个元素
var $li = $("li");

// 获取匹配到的第2个元素，即n5
var $n5 = $li.eq(1);
document.writeln( $n5.attr("id") ); // n5

// 获取匹配到的第4个元素，即n9
var $n9 = $li.eq(3);
document.writeln( $n9.attr("id") ); // n9

// 获取匹配到的第-3个元素，即n6
var $n6 = $li.eq(-3);
document.writeln( $n6.attr("id") ); // n6

运行代码