内容目录
parentsUntil()函数用于选取每个匹配元素的所有祖先元素，直到遇到符合指定表达式的元素为止，并以jQuery对象的形式返回。
这里的表达式是指：选择器(字符串)、DOM元素(Element)、jQuery对象。
你还可以使用选择器来进一步缩小选取范围，只选取其中符合指定选择器的元素。
该函数属于jQuery对象(实例)。
语法
jQuery 1.4 新增该函数。
jQueryObject.parentsUntil( [ untilExpr [, filter ] ] )参数
| 参数 | 描述 |
|---|---|
| untilExpr | 可选/String/Element/jQuery类型指定的表达式，如果当前匹配过程中遇到符合该表达式的元素就停止当前匹配。 |
| filter | 可选/String类型指定的选择器字符串，用于筛选匹配的元素。 |
parentsUntil()函数将选取当前jQuery对象每个匹配元素的所有祖先元素，直到遇到符合指定表达式untilExpr的元素(不包括该元素)为止。此外，我们还可以指定filter参数，用于进一步缩小筛选范围，选取出符合选择器filter的元素。
如果省略untilExpr参数，则选取所有的祖先元素。
jQuery 1.6 新增支持：参数untilExpr可以为DOM元素(Element)或jQuery对象。
返回值
parentsUntil()函数的返回值为jQuery类型，返回一个新的jQuery对象，该对象封装了当前jQuery对象每个匹配元素之后的所有符合选择器filter(如果指定了的话)的同辈元素，直到遇到符合指定表达式untilExpr的元素为止。
如果没有符合条件的元素，则返回空的jQuery对象。
示例&说明
parentsUntil()函数与parents()函数具有如下等价代码：
// 这里的selector表示任意的选择器
// 两者均不带任何参数
$("selector").parentsUntil( );
// 等价于
$("selector").parents( );以下面这段HTML代码为例：
<!DOCTYPE html>
<html>
<body>
<div id="n1">
<p id="n2"></p>
<p id="n3">
<span id="n4" class="foo">CodePlayer</span>
</p>
</div>
<div id="n5" class="bar">
<p id="n6" class="foo">
<span id="n7">专注于编程开发技术分享</span>
</p>
</div>
</body>
</html>以下jQuery示例代码用于演示parentsUntil()函数的具体用法：
// 返回jQuery对象所有匹配元素的标识信息数组
// 每个元素形如：tagName或tagName#id(如果有id的话)
function getTagsInfo($doms){
return $doms.map(function(){
return this.tagName + (this.id ? "#" + this.id : "");
}).get();
}
var $n4 = $("#n4");
//获取n4的所有祖先元素，直到遇到div元素为止
var $parents1 = $n4.parentsUntil("div");
document.writeln( getTagsInfo( $parents1 ) ); // P#n3
var $p = $("p");
//获取所有p元素的祖先元素，直到遇到body元素为止
var $parents2 = $p.parentsUntil("body");
document.writeln( getTagsInfo( $parents2 ) ); // DIV#n5,DIV#n1
var $foo = $(".foo");
//获取所有包含类名"foo"的所有祖先元素
// 不带任何参数的parentsUntil()函数等价于不带任何参数的parents()函数
var $parents3 = $foo.parentsUntil( );
document.writeln( getTagsInfo( $parents3 ) ); // DIV#n5,P#n3,DIV#n1,BODY,HTML
var $span = $("span");
//获取所有span元素的包含类名"foo"的祖先元素，直到遇到div元素为止
var $parents4 = $span.parentsUntil("div", ".foo");
document.writeln( getTagsInfo( $parents4 ) ); // P#n6
0 条评论
撰写评论