.nextUntil()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

.nextUntil()

分类:遍历 > 树遍历

返回: jQuery

.nextUntil( [selector ] [, filter ] )

描述:获得每个元素所有后面的同辈元素,向后直到遇到匹配选择器、DOM节点或者jQuery对象的那个元素(但是不包含这个匹配的元素)。

加入于: 1.4
.nextUntil( [selector ] [, filter ] )
  • selector
    类型:Selector
    一个字符串,它包含了一个选择器表达式,用来表示在哪里停止匹配后面的同辈元素。
  • filter
    类型:Selector
    一个字符串,它包含了一个选择器表达式,用来匹配所针对的元素。
加入于: 1.6
.nextUntil( [element ] [, filter ] )
  • element
    类型:Element or jQuery
    一个DOM节点,或者jQuery对象,表示在哪里停止匹配后面的同辈元素。
  • filter
    类型:Selector
    一个字符串,它包含了一个选择器表达式,用来匹配所针对的元素。

给定一个jQuery对象,代表了一个DOM元素的集合,.nextUntil()方法允许我们搜索遍DOM树中这些元素后面的同辈元素,直到它达到一个匹配方法的参数的元素才停止。返回的新的jQuery对象包含了所有的后面的同辈元素,直到但是不包括.nextUntil()的参数匹配到的那个元素。

如果没有提供该选择器或者提供了但是没匹配到,则所有后面跟着的同辈元素都会被选中;那样的话,它就和不提供筛选选择器的.nextAll()方法选择了同样的元素。

自从jQuery 1.6,1个DOM节点或者jQuery对象,代替了一个选择器,可能传递给.nextUntil()方法。

该方法可以视情况接受一个选择器表达式作为它的第二个参数。如果提供了该参数,将筛选元素,测试它们是否匹配该选择器。

示例

找到跟在<dt id="term-2">后面的直到下一个<dt>的同辈元素,并给它们红色背景。还要找到跟在<dt id="term-1">后面、直到<dt id="term-3">的<dd>同辈元素,给它们绿色的文本颜色。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>nextUntil demo</title>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<dl>
  <dt id="term-1">term 1</dt>
  <dd>definition 1-a</dd>
  <dd>definition 1-b</dd>
  <dd>definition 1-c</dd>
  <dd>definition 1-d</dd>
  <dt id="term-2">term 2</dt>
  <dd>definition 2-a</dd>
  <dd>definition 2-b</dd>
  <dd>definition 2-c</dd>
  <dt id="term-3">term 3</dt>
  <dd>definition 3-a</dd>
  <dd>definition 3-b</dd>
</dl>
 
<script>
$( "#term-2" )
  .nextUntil( "dt" )
    .css( "background-color", "red" );
var term3 = document.getElementById( "term-3" );
$( "#term-1" )
  .nextUntil( term3, "dd" )
    .css( "color", "green" );
</script>
 
</body>
</html>

演示结果

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/nextuntil.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。