.prevUntil()

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

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

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

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

自从jQuery 1.6以来,可以向.prevUntil()的第一个参数传递一个DOM节点或jQuery对象,代替了选择器。

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

示例:

找到位于<dt id="term-2">前面的同辈元素,直到上一个<dt>,并给它们红色背景。此外,找到位于<dd> siblings of <dt id="term-3">前面的<dd>同辈元素,直到<dt id="term-1">,并给它们绿色文字色。

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
37
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>prevUntil 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" ).prevUntil( "dt" )
.css( "background-color", "red" );
var term1 = document.getElementById( "term-1" );
$( "#term-3" ).prevUntil( term1, "dd" )
.css( "color", "green" );
</script>
</body>
</html>

演示: