CodePlayer

next()函数用于筛选每个匹配元素之后紧邻的同辈元素，并以jQuery对象的形式返回。

你还可以使用指定的选择器进一步缩小筛选范围，筛选出符合指定选择器的元素。

与该函数相对的是prev()函数，用于筛选每个匹配元素之前紧邻的同辈元素。

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

语法

jQueryObject.next( [ selector ] )

参数

next()函数将在当前jQuery对象每个匹配元素的下一个相邻的同辈元素中筛选符合指定选择器的元素。

如果省略selector参数，则选取每个匹配元素的下一个相邻的同辈元素。

返回值

next()函数的返回值为jQuery类型，返回一个新的jQuery对象，该对象封装了当前jQuery对象所有匹配元素的下一个紧邻的符合指定选择器的同辈元素。

如果没有符合条件的元素，则返回空的jQuery对象。

示例&说明

next()函数与prev + next选择器具有以下等价代码：

// 这里的selector、selector1均表示任意的选择器
$("selector").next("selector1");
// 等价于
$("selector + selector1");


$("selector").next( );
// 等价于
$("selector + *");

以下面这段HTML代码为例：

<p id="e1">
	<span id="e2" class="site">
		<span id="e3" class="item site-name">CodePlayer</span>
		<span id="e4" class="item site-desc">专注于编程开发技术分享</span>
	</span>
	<span id="e5" class="site-url">https://codeplayer.vip</span>
</p>
<p id="e6">
	JavaScript<span id="e7" class="highlight">jQuery</span>
	<a id="e8" href="https://codeplayer.vip">CodePlayer</a>
	<span id="e9" class="highlight">PHP</span>
</p>

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

// 返回jQuery对象所有匹配元素的标识信息数组
// 每个元素形如：tagName或tagName#id(如果有id的话)
function getTagsInfo($doms){
	return $doms.map(function(){
		return this.tagName + (this.id ? "#" + this.id : "");
	}).get();
}

// 匹配所有span元素：e2、e3、e4、e5、e7、e9
var $span = $("span");
// 匹配所有span元素之后紧邻的同辈元素：e5、e4、e8
// e2的下一个紧邻的同辈元素是e5
// e3的是e4
// e4没有(因为它是同辈元素中的最后一个，下同)
// e5没有
// e7的是e8
// e9没有
var $span_next = $span.next( );
document.writeln( getTagsInfo( $span_next ) ); // SPAN#e5,SPAN#e4,A#e8

// 匹配所有span元素之后紧邻的同辈span元素
var $span_next_span = $span.next( "span" );
document.writeln( getTagsInfo( $span_next_span ) ); // SPAN#e5,SPAN#e4

运行代码