jQuery 遍历 - parentsUntil() 方法

实例

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

  1. $("li.item-a").parentsUntil(".level-1")
  2.   .css("background-color", "red");
  3.  
  4. $("li.item-2").parentsUntil( $("ul.level-1"), ".yes" )
  5.   .css("border", "3px solid blue");

定义和用法

parentsUntil() 获得当前匹配元素集合中每个元素的祖先元素，直到（但不包括）被选择器、DOM 节点或 jQuery 对象匹配的元素。

语法 1

  1. .parentsUntil(selector,filter)
参数 描述
selector 可选。字符串值，规定在何处停止对祖先元素进行匹配的选择器表达式。
filter 可选。字符串值，包含用于匹配元素的选择器表达式。

语法 2

  1. .parentsUntil(element,filter)
参数 描述
element 可选。DOM 节点或 jQuery 对象，指示在何处停止对祖先元素的匹配。
filter 可选。字符串值，包含用于匹配元素的选择器表达式。

详细说明

如果给定一个表示 DOM 元素集合的 jQuery 对象，.parentsUntil() 方法允许我们在 DOM 树中搜索这些元素的祖先元素，直到遇到被选择器（传递到方法中的参数）匹配的元素为止。返回的 jQuery 对象包含所有祖先元素，但不包括由 .parentsUntil() 方法规定的选择器匹配的那个元素。

如果不匹配或未应用选择器，则将选区所有祖先元素；在这种情况下，该方法选取的元素与未提供选择器时的 .parents() 相同。

对于 jQuery 1.6，DOM 节点或 jQuery 对象，而不是选择器，可用作 .parentsUntil() 方法的第一个参数。

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