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>
运行实例 »

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