CodePlayer

first()函数用于获取当前jQuery对象所匹配的元素中的第一个元素，并返回封装该元素的jQuery对象。

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

语法

jQuery 1.4 新增该函数。

jQueryObject.first( )

返回值

first()函数的返回值为jQuery类型，返回封装了第一个匹配元素的jQuery对象。

如果当前jQuery对象没有匹配任何元素，自然也不存在第一个匹配到的元素，此时将返回空的jQuery对象。

示例&说明

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

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

以下面这段HTML代码为例：

<div id="n1">
	<div id="n2">
		<ul id="n3">
			<li id="n4">item1</li>
			<li id="n5" class="list">item2</li>
			<li id="n6" class="list">item3</li>
		</ul>
	</div>
</div>

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

// 获取第1个li元素，即n4
// 先匹配所有li元素，再获取其中的第一个
document.writeln( $("li").first().attr("id") ); // n4

// 获取第1个li.list元素，即n5
// 先匹配所有的li.list元素，再获取其中的第一个
document.writeln( $("li.list").first().attr("id") ); // n5

// 获取第1个div元素，即n1
// 先匹配所有div元素，再获取其中的第一个
document.writeln( $("div").first().attr("id") ); // n1

运行代码