parents

英 ['peərənts]   美 ['peərənts]  

n.双亲（ parent的名词复数 ）

until

英 [ənˈtɪl]   美 [ʌnˈtɪl]  

prep.到…为止;在…以前

conj.到…为止，在…以前;直到…才

jquery parentsUntil()方法 语法

作用：parentsUntil() 获得当前匹配元素集合中每个元素的祖先元素，直到（但不包括）被选择器、DOM 节点或 jQuery 对象匹配的元素。

语法1：.parentsUntil(selector,filter)

参数：

参数描述
selector    可选。字符串值，规定在何处停止对祖先元素进行匹配的选择器表达式。
filter    可选。字符串值，包含用于匹配元素的选择器表达式。

语法2：.parentsUntil(element,filter)

参数：

参数描述
element    可选。DOM 节点或 jQuery 对象，指示在何处停止对祖先元素的匹配。
filter    可选。字符串值，包含用于匹配元素的选择器表达式。

说明：如果给定一个表示 DOM 元素集合的 jQuery 对象，.parentsUntil() 方法允许我们在 DOM 树中搜索这些元素的祖先元素，直到遇到被选择器（传递到方法中的参数）匹配的元素为止。返回的 jQuery 对象包含所有祖先元素，但不包括由 .parentsUntil() 方法规定的选择器匹配的那个元素。如果不匹配或未应用选择器，则将选区所有祖先元素；在这种情况下，该方法选取的元素与未提供选择器时的 .parents() 相同。对于 jQuery 1.6，DOM 节点或 jQuery 对象，而不是选择器，可用作 .parentsUntil() 方法的第一个参数。该方法接受可选的选择器表达式作为其第二参数。如果应用这个参数，则将通过检测元素是否匹配该选择器对元素进行筛选。

jquery parentsUntil()方法 示例

<!DOCTYPE html>
<html>
<head>
  <script type="text/javascript" src="http://apps.bdimg.com/libs/jquery/2.1.1/jquery.min.js"></script>
</head>

<body>
<ul class="level-1 yes">
  <li class="item-i">I</li>
  <li class="item-ii">II
    <ul class="level-2 yes">
      <li class="item-a">A</li>
      <li class="item-b">B
        <ul class="level-3">
          <li class="item-1">1</li>
          <li class="item-2">2</li>
          <li class="item-3">3</li>
        </ul>
      </li>
      <li class="item-c">C</li>
    </ul>
  </li>
  <li class="item-iii">III</li>
</ul>

<script>
$("li.item-a").parentsUntil(".level-1")
  .css("background-color", "red");

$("li.item-2").parentsUntil( $("ul.level-1"), ".yes" )
  .css("border", "3px solid blue");
</script>
</body>
</html>
运行实例 »

点击 "运行实例" 按钮查看在线实例