nextUntil([e|e][,f])

返回值

jQuery

概述

查找当前元素之后所有的同辈元素,直到遇到匹配的那个元素为止。

如果提供的jQuery代表了一组DOM元素,.nextUntil()方法也能让我们找遍所有元素所在的DOM树,直到遇到了一个跟提供的参数匹配的元素的时候才会停下来。这个新jQuery对象里包含了下面所有找到的同辈元素,但不包括那个选择器匹配到的元素。

如果没有选择器匹配到,或者没有提供参数,那么跟在后面的所有同辈元素都会被选中。这就跟用没有提供参数的 .nextAll()效果一样。

参数

参数 类型 说明 示例值
[expr][,filter] String,String
v1.4

expr: 用于筛选祖先元素的表达式。
filter: 一个字符串,其中包含一个选择表达式匹配元素。

[element][,filter] DOMElement,String
v1.6

element: 用于筛选祖先元素的DOM元素。
filter: 一个字符串,其中包含一个选择表达式匹配元素。

示例

描述:给#term-2后面直到dt前的元素加上红色背景

HTML 代码

<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>

jQuery 代码

$('#term-2').nextUntil('dt').css('background-color', 'red');

var term3 = document.getElementById("term-3");
$("#term-1").nextUntil(term3, "dd").css("color", "green");

结果

  1. term 1
  2. definition 1-a
  3. definition 1-b
  4. definition 1-c
  5. definition 1-d
  6. term 2
  7. definition 2-a
  8. definition 2-b
  9. definition 2-c
  10. term 3
  11. definition 3-a
  12. definition 3-b