CodePlayer

nextAll()函数用于选取每个匹配元素之后的所有同辈元素，并以jQuery对象的形式返回。

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

与该函数相对的是prevAll()函数，用于选取每个匹配元素之前的所有同辈元素。

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

语法

jQuery 1.2 新增该函数。

jQueryObject.nextAll( [ selector ] )

参数

nextAll()函数将在当前jQuery对象每个匹配元素之后的同辈元素中筛选符合指定选择器的元素。

如果省略selector参数，则选取每个匹配元素之后的所有同辈元素。

返回值

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

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

示例&说明

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

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


$("selector").nextAll( );
// 等价于
$("selector ~ *");

以下面这段HTML代码为例：

<p id="n1">
	<span id="n2">
		<span id="n3">A</span>
	</span>
	<label id="n4">B</label>
	<span id="n5">
		<span id="n6">C</span>
	</span>
	<strong id="n7" class="active">D</strong>
	<span id="n8" class="active">E</span>
</p>
<p id="n9">
	<span id="n10"></span>
	<label id="n11"></label>
	<span id="n12" class="active"></span>
</p>

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

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

var $n4 = $("#n4");
//匹配n4之后所有的同辈元素
var $n4_nextAll = $n4.nextAll();
document.writeln( getTagsInfo( $n4_nextAll ) ); // #n5,#n7,#n8

//匹配n4之后的所有同辈strong元素
var $n4_nextAll_strong = $n4.nextAll("strong");
document.writeln( getTagsInfo( $n4_nextAll_strong ) ); // #n7

var $label = $("label");
var $label_nextAll_active = $label.nextAll(".active");
document.writeln( getTagsInfo( $label_nextAll_active ) ); // #n7,#n8,#n12

运行代码