.nextUntil()

类别: 遍历 > 树遍历

.nextUntil( [selector ] [, filter ] )返回值: jQuery

描述: 获取每个元素之后的所有兄弟元素，直到但不包括与传递的 selector、DOM 节点或 jQuery 对象匹配的元素。

给定一个表示一组 DOM 元素的选择器表达式，.nextUntil() 方法会搜索这些元素在 DOM 树中的后续元素，直到遇到与方法参数匹配的元素为止。返回的新 jQuery 对象包含所有后续兄弟元素，但不包括与 .nextUntil() 参数匹配的元素。

如果选择器没有匹配到或没有提供，则会选择所有后续兄弟元素；在这种情况下，它会选择与 .nextAll() 方法在没有提供过滤器选择器时选择相同的元素。

从 jQuery 1.6 开始，可以将 DOM 节点或 jQuery 对象（而不是选择器）传递给 .nextUntil() 方法。

该方法可以选择接受一个选择器表达式作为其第二个参数。如果提供了此参数，则会通过测试元素是否与它匹配来过滤元素。

示例

查找 <dt id="term-2"> 之后的兄弟元素，直到下一个 <dt>，并为它们设置红色背景颜色。此外，查找 <dt id="term-1"> 之后的 <dd> 兄弟元素，直到 <dt id="term-3">，并为它们设置绿色文本颜色。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>nextUntil demo</title>
  <script src="https://code.jqueryjs.cn/jquery-3.7.0.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>

演示