概述 .prevUntil( [selector ] [, filter ] )
返回值:jQuery
描述: 获取每个元素但不包括选择器,DOM节点,或者jQuery对象匹配的元素的所有前面的兄弟元素。
如果提供的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.
<!DOCTYPE html>
<html>
<head>
<script src="http://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>