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

jQuery.nextUntil() 函数详解

nextUntil()函数用于选取每个匹配元素之后所有的同辈元素,直到遇到符合指定表达式的元素为止,并以jQuery对象的形式返回。

这里的表达式是指:选择器(字符串)、DOM元素(Element)、jQuery对象。

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

与该函数相对的是prevUntil()函数,用于选取每个匹配元素之前所有的同辈元素,直到遇到符合指定表达式的元素为止。

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

语法

jQuery 1.4 新增该函数。

jQueryObject.nextUntil( [ untilExpr [, filter ] ] )

参数

参数描述
untilExpr可选/String/Element/jQuery类型指定的表达式,如果当前匹配过程中遇到符合该表达式的元素就停止当前匹配。
filter可选/String类型指定的选择器字符串,用于筛选匹配的元素。

nextUntil()函数将选取当前jQuery对象每个匹配元素之后的所有同辈元素,直到遇到符合指定表达式untilExpr的元素(不包括该元素)为止。此外,我们还可以指定filter参数,用于进一步缩小筛选范围,选取出符合filter选择器的元素。

如果省略untilExpr参数,则一直选取到同辈元素末尾。

jQuery 1.6 新增支持:参数untilExpr可以为DOM元素(Element)或jQuery对象

返回值

nextUntil()函数的返回值为jQuery类型,返回一个新的jQuery对象,该对象封装了当前jQuery对象每个匹配元素之后的所有符合选择器filter(如果指定了的话)的同辈元素,直到遇到符合指定表达式untilExpr的元素为止。

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

示例&说明

nextUntil()函数与nextAll()函数具有如下等价代码:

// 这里的selector表示任意的选择器
// 两者均不带任何参数
$("selector").nextUntil( );
// 等价于
$("selector").nextAll( );

以下面这段HTML代码为例:

<dl id="n1">
  <dt id="n2">关键词1</dt>
  <dd id="n3">描述1-1</dd>
  <dd id="n4" class="stop">描述1-2</dd>
  <dd id="n5">描述1-3</dd>
  
  <dt id="n6">关键词2</dt>
  <dd id="n7">描述 2-1</dd>
  <dd id="n8" class="active">描述 2-2</dd>
  <dd id="n9" class="stop">描述 2-3</dd>

  <dt id="n10">关键词3</dt>
  <dd id="n11">描述 3-1</dd>
  <dd id="n12">描述 3-2</dd>
</dl>

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

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

var $n6 = $("#n6");

// 匹配n6之后的所有同辈元素,一直到遇到dt元素为止
var $elements = $n6.nextUntil("dt");
document.writeln( getTagsInfo( $elements ) ); // DD#n7,DD#n8,DD#n9

// 匹配n6之后所有包含类名active的同辈元素,直到遇到dt元素为止
var $matches = $n6.nextUntil("dt", ".active");
document.writeln( getTagsInfo( $matches ) ); // DD#n8

var $dt = $("dt");
// 匹配所有dt元素之后的所有同辈元素,直到遇到包含类名stop的元素为止
var $stop = $dt.nextUntil(".stop");
document.writeln( getTagsInfo( $stop ) ); // DD#n3,DD#n7,DD#n8,DD#n11,DD#n12

var $n10 = $("#n10");
// 不带任何参数的nextUntil()函数等价于不带任何参数的nextAll()函数
var $result = $n10.nextUntil( );
document.writeln( getTagsInfo( $result ) ); // DD#n11,DD#n12

运行代码

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

帮朋友打一个硬广告:

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

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

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