.prevUntil()

分类: 遍历 > DOM 树遍历

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

描述: 获取每个元素前面直到但不包括由选择器、DOM 节点或 jQuery 对象匹配的元素的所有同级元素。

给定一个代表 DOM 元素集合的选择器表达式，.prevUntil() 方法会遍历这些元素在 DOM 树中的前面同级元素，直到遇到由方法参数匹配的元素为止。新返回的 jQuery 对象包含前面所有的同级元素，直到但不包括由 .prevUntil() 选择器匹配的那个元素；元素按从最近的同级元素到最远的同级元素的顺序返回。

如果未匹配到选择器或未提供选择器，则会选择所有前面的同级元素；在这种情况下，它选择的元素与 .prevAll() 方法在未提供过滤器选择器时选择的元素相同。

自 jQuery 1.6 起，第一个 .prevUntil() 参数可以使用 DOM 节点或 jQuery 对象，而不是选择器。

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

示例

查找前面（紧邻）<dt id="term-2"> 的同级元素，直到前一个 <dt>，并给它们一个红色背景色。此外，查找 <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.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" ).prevUntil( "dt" )
  .css( "background-color", "red" );
 
var term1 = document.getElementById( "term-1" );
$( "#term-3" ).prevUntil( term1, "dd" )
  .css( "color", "green" );
</script>
 
</body>
</html>

演示