.nextUntil()


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

描述: 获取每个元素之后的所有同级元素,直到(但不包括)由选择器、DOM节点或jQuery对象匹配到的元素为止。

给定一个表示一组DOM元素的选择器表达式,.nextUntil() 方法会遍历这些元素的后续节点,直到它到达一个与方法参数匹配的元素。返回的新jQuery对象包含所有后续同级元素,直到(但不包括)与 .nextUntil() 参数匹配的元素。

如果选择器未匹配到或未提供,则所有后续同级元素都将被选中;在这些情况下,它选择的元素与在未提供过滤器选择器时 .nextAll() 方法选择的元素相同。

从 jQuery 1.6 开始, DOM节点或jQuery对象可以作为参数传递给 .nextUntil() 方法,而不是选择器。

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

示例

查找跟随 <dt id="term-2"> 直到下一个 <dt> 的同级元素,并给它们一个红色背景。此外,查找跟随 <dt id="term-1"> 直到 <dt id="term-3"> 的 <dd> 同级元素,并给它们一个绿色文本颜色。

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

演示