返回值:jQueryprevUntil([selector])
查找当前元素之前所有的同辈元素,直到遇到选择器匹配的元素为止,不包括那个匹配到的元素。
-
1.4 新增prevUntil([selector])
selector (Selector) 可选参数,选择器字符串,用于确定到哪个排在前面的同辈元素时停止匹配。
如果提供的jQuery代表了一组DOM元素, .prevUntil()
方法会找遍所有元素所在的DOM树中排在它们前面的元素,直到遇到了一个跟提供的参数匹配的元素的时候才会停下来。这个新jQuery对象里包含了前面所有找到的同辈元素,但不包括提供给 .prevUntil()
的选择器匹配到的元素。
如果提供的选择器没有匹配到任何东西,或者干脆没有提供选择器,那么排在前面的所有同辈元素都会被选中。这就跟用没有提供参数的 .prevAll()
效果一样。
考虑如下的定义列表:
<dl> <dt>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>term 3</dt> <dd>definition 3-a</dd> <dd>definition 3-b</dd> </dl>
如果我们从 term 2 开始,查找在它之前的所有元素,直到 <dt>
为止。
$('#term-2').prevUntil('dt').css('background-color', 'red');
其结果是使 definitions 1-a
, 1-b
, 1-c
, 和 1-d
的背景变为红色。
示例:
查找排在 <dt id="term-2"> 之前的同辈元素,直到 <dt> 为止,并把它们的背景都设成红色。
<!DOCTYPE html>
<html>
<head>
<script src="jquery.min.js"></script>
</head>
<body>
<dl>
<dt>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>term 3</dt>
<dd>definition 3-a</dd>
<dd>definition 3-b</dd>
</dl>
<script>
$("#term-2").prevUntil("dt")
.css("background-color", "red")
</script>
</body>
</html>