.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>
演示结果