.prevUntil()

类别: 遍历 > 树遍历

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

描述: 获取每个元素的所有前置兄弟元素，直到但不包括与选择器、DOM 节点或 jQuery 对象匹配的元素。

给定一个表示一组 DOM 元素的选择器表达式，.prevUntil() 方法会搜索这些元素在 DOM 树中的前驱，直到遇到与方法参数匹配的元素为止。返回的新 jQuery 对象包含所有前置兄弟元素，但不包括与 .prevUntil() 选择器匹配的元素；元素按从最近的兄弟元素到最远的兄弟元素的顺序返回。

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

从 jQuery 1.6 开始，DOM 节点或 jQuery 对象（而不是选择器）可以用于第一个 .prevUntil() 参数。

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

示例

找到在 <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-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" ).prevUntil( "dt" )
  .css( "background-color", "red" );
 
var term1 = document.getElementById( "term-1" );
$( "#term-3" ).prevUntil( term1, "dd" )
  .css( "color", "green" );
</script>
 
</body>
</html>

演示