.prevUntil()

.prevUntil( [ selector ] ) 官网原E文: jQuery

描述: 获取每个元素但不包括选择器匹配的元素的所有前面的兄弟元素。

  • version added: 1.4.prevUntil( [ 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 的背景变为红色。

Example:

查找排在 <dt id="term-2"> 之前的同辈元素,直到 <dt> 为止,并把它们的背景都设成红色。

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

Demo:

jQuery 1.6 API 中文版Clove整理、修订