返回值:jQueryprevUntil([selector], [filter])
查找在当前元素集中,每个元素之前的所有兄弟元素,直到遇到与选择器, DOM 节点或 jQuery 对象匹配的元素为止,但不包括这些元素。
-
1.4 新增prevUntil([selector], [filter])
selector (Selector) 可选参数,选择器字符串,用于确定匹配到之前的哪个兄弟元素时停止匹配。filter (Selector) 可选参数,用于匹配元素的选择器表达式字符串。 -
1.6 新增prevUntil([element], [filter])
element (Element) 可选参数,DOM 节点或 jQuery 对象,用于确定匹配到之前的哪个兄弟元素时停止匹配。filter (Selector) 可选参数,用于匹配元素的选择器表达式字符串。
如果提供一个选择器表达式代表DOM元素集合, .prevUntil()
方法会查找这些元素所在的DOM树中排在它们前面的元素,直到遇到了一个跟提供的参数匹配的元素的时候才会停下来。新返回的 jQuery 对象里包含了前面所有找到的兄弟元素,但不包括提供给 .prevUntil()
的选择器匹配到的元素。返回的结果中,元素按照由近及远的顺序排列。
如果提供的选择器没有匹配到任何元素,或者没有提供选择器,那么之前的所有兄弟元素都会被选中。其效果与没有提供参数的 .prevAll()
一样。
从 jQuery 1.6 开始, 可以使用 DOM 节点 或 jQuery 对象作为 .prevUntil() 的第一个参数。
该方法的 filter 参数是可选的。如果提供了此参数,就按照此参数指定的选择器表达式进行筛选。
示例:
查找 <dt id="term-2"> 之前的所有兄弟元素,直到遇到 <dt> 为止,并将它们的背景设为红色。同样的,查找 <dt id="term-3"> 之前 <dd> 的所有兄弟元素,直到遇到 <dt id="term-1"> 为止,并将它们的文字颜色设为绿色。
<!DOCTYPE html>
<html>
<head>
<script src="jquery.min.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>