# .prevUntil()

所属分类：遍历 > 树遍历 英文文档：.prevUntil()

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

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

- #### 添加的版本: 1.4.prevUntil( [selector ] [, filter ] )

  - selector
    类型: Selector
    选择器字符串，用于确定到哪个排在前面的同辈元素时停止匹配
  - filter
    类型: Selector
    一个字符串，其中包含一个选择器表达式用来匹配的元素。

- #### 添加的版本: 1.6.prevUntil( [element ] [, filter ] )

  - element
    类型: Element
    一个DOM节点或jQuery对象说明哪里开始停止匹配接下来的同级元素。
  - filter
    类型: Selector
    一个字符串，其中包含一个选择器表达式用来匹配的元素。

如果提供的jQuery代表了一组DOM元素， `.prevUntil()` 方法会找遍所有元素所在的DOM树中排在它们前面的元素，直到遇到了一个跟提供的参数匹配的元素的时候才会停下来。这个新jQuery对象里包含了前面所有找到的同辈元素，但不包括提供给 `.prevUntil()` 的选择器匹配到的元素。返回的元素顺序是从最靠近的兄弟元素到最远的兄弟元素。

如果提供的选择器没有匹配到任何东西，或者干脆没有提供选择器，那么排在前面的所有同辈元素都会被选中。这就跟用没有提供参数的 `.prevAll()` 效果一样。

从 jQuery 1.6 开始, 一个DOM节点或jQuery对象， 而不是一个选择器， 可被传递到`.prevUntil()`方法。

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

## 例子:

#### Find the siblings that precede <dt id="term-2"> up to the preceding <dt> and give them a red background color. Also, find previous <dd> siblings of <dt id="term-3"> up to <dt id="term-1"> and give them a green text color.

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 |
    <!DOCTYPE html><html><head>  <script src="https://code.jquery.com/jquery-latest.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>

#### Demo: