.nextUntil()

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

描述:取所每个元素所有后跟着的同辈元素,直到但不包括被传入的选择器、DOM节点或jQuery对象所匹配的元素。

给定一个选择器表达式,代表一个DOM元素集合,.nextUntil()方法在DOM树中搜索遍这些元素的后续者,当它搜索到一个被此方法的参数匹配的元素时,停止搜索。新的jQuery对象返回包含所有的后续的同辈元素,直到但是不包括被.nextUntil()参数匹配的元素。

如果没有元素匹配选择器,或者如果没有提供选择器,所有后续的同辈元素都会被选中;在那种情况下,它选择了与.nextAll()方法不提供筛选器选择器时相同的元素。

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

此方法可以选择性接受一个选择器表达式作为它的第二个参数。如果提供了此参数,将通过测试元素是否匹配选择器的方式来筛选这些元素。

示例:

找到跟在<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.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>

演示: