jQuery 遍历 - parentsUntil() 方法

实例

查找 <li class="item-a"> 的祖先元素,直到 <ul class="level-1">,并将它们设置为红色背景。同时,找到 <li class="item-2"> 的所有类名为 "yes" 的祖先元素,直到 <ul class="level-1">,然户为它们设置蓝色边框:

$("li.item-a").parentsUntil(".level-1")
  .css("background-color", "red");

$("li.item-2").parentsUntil( $("ul.level-1"), ".yes" )
  .css("border", "3px solid blue");

定义和用法

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() 方法的第一个参数。

该方法接受可选的选择器表达式作为其第二参数。如果应用这个参数,则将通过检测元素是否匹配该选择器对元素进行筛选。