.parentsUntil()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

.parentsUntil()

分类:遍历 > 树遍历

返回: jQuery

.parentsUntil( [selector ] [, filter ] )

描述:获得匹配的元素的当前集合中的每个元素的祖先元素,向上直到遇到匹配选择器、DOM节点或者jQuery对象的那个元素(但是不包含这个匹配的元素)。

加入于: 1.4
.parentsUntil( [selector ] [, filter ] )
  • selector
    类型:Selector
    一个字符串,它包含了一个选择器表达式,以表示在哪里停止匹配祖先元素。
  • filter
    类型:Selector
    一个字符串,它包含了一个选择器表达式,用来匹配所针对的元素。
加入于: 1.6
.parentsUntil( [element ] [, filter ] )
  • element
    类型:Element or jQuery
    一个DOM节点或jQuery对象,表示在哪里停止匹配祖先元素。
  • filter
    类型:Selector
    一个字符串,它包含了一个选择器表达式,用来匹配所针对的元素。

给定一个代表一个DOM元素的集合的选择器表达式,.parentsUntil()方法会遍历这些元素的祖先元素,直到它接触到一个元素,它匹配传递给方法的参数的选择器。产生的jQuery对象包含了所有找到的祖先元素,但是不包括与.parentsUntil()的选择器相匹配的那个元素。

如果没有提供该选择器或者提供了但是没匹配到,则所有的祖先元素都会被选中;那样的话,,它就和不提供选择器的.parents()方法选择了同样的元素。

自从jQuery 1.6版,.parentsUntil()的第一个参数可以用一个DOM节点或jQuery对象,代替一个选择器。

该方法视情况接受一个选择器表达式,作为它的第二个参数。如果提供了该参数,将筛选元素,测试它们是否匹配该选择器。

示例

找到所有的<li class="item-a">的祖先元素,直到<ul class="level-1">,并给它们一个红色的背景颜色。而且,还要找到<li class="item-2">的祖先元素,上溯到带有样式类“yes”的<ul class="level-1">,然后给它们一个绿色的边框。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>parentsUntil demo</title>
  <script src="https://code.jquery.com/jquery-1.10.2.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 green" );
</script>
 
</body>
</html>

演示结果

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/parentsuntil.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。