.nextUntil()

.nextUntil( [ selector ] ) 返回: jQuery

描述: 获取每个当前元素之后所有的同辈元素,但不包括选择器匹配的元素。

  • version added: 1.4.nextUntil( [ selector ] )

    selector选择器字符串,用于确定到哪个前辈元素时停止匹配。

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

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

考虑一个页面上一个简单的列表:

<dl>
  <dt>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>term 3</dt>
  <dd>definition 3-a</dd>
  <dd>definition 3-b</dd>
</dl>

如果我们从 term 2 开始,查找在它之后的所有元素,直到 <dt>为止

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

其结果是使 definition 2-a, 2-b, and 2-c 的背景变为红色。

Example:

查找跟在 <dt id="term-2"> 之后的同辈元素,直到 <dt> 为止,并把它们的背景都设成红色。

<!DOCTYPE html>
<html>
<head>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
  <dl>
  <dt>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>term 3</dt>
  <dd>definition 3-a</dd>
  <dd>definition 3-b</dd>
</dl>
<script>
    $("#term-2").nextUntil("dt")
      .css("background-color", "red")
</script>

</body>
</html>

Demo:

jQuery 1.6 API 中文版脚本之家整理、修订 (2011年6月)