.parentsUntil()
返回: jQuery
.parentsUntil( [selector ] [, filter ] )
描述:获得匹配的元素的当前集合中的每个元素的祖先元素,向上直到遇到匹配选择器、DOM节点或者jQuery对象的那个元素(但是不包含这个匹配的元素)。
给定一个代表一个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>
演示结果