jQuery 遍历 - prevUntil() 方法

实例

查找 <dt id="term-2"> 之前的同胞元素,直到前一个 <dt>,并将它们设置为红色。同时,查找 <dt id="term-3"> 前面的 <dd> 同胞,直到 <dt id="term-1">,并把它们设置为蓝色文本:

$("#term-2").prevUntil("dt").css("background-color", "red");
var term1 = document.getElementById('term-1');
$("#term-3").prevUntil(term1, "dd").css("color", "green");

定义和用法

prevUntil() 方法获得当前匹配元素集合中每个元素的前面的同胞元素,但不包括被选择器、DOM 节点或 jQuery 对象匹配的元素。

语法 1

.prevUntil(_selector_, _filter_)
参数 描述
selector 可选。字符串值,包含指示在何处停止匹配前方同胞元素的选择器表达式。
filter 可选。字符串值,包含用于匹配元素的选择器表达式。

语法 2

.prevUntil(_element_, _filter_)
参数 描述
element 可选。指示在何处停止匹配前方同胞元素的 DOM 节点或 jQuery 对象。
filter 可选。字符串值,包含用于匹配元素的选择器表达式。

详细说明

如果给定一个表示 DOM 元素集合的 jQuery 对象,.prevUntil() 方法允许我们在 DOM 树中搜索这些元素前面的同胞元素,直到遇到被选择器(传递到方法中的参数)匹配的元素为止。返回的 jQuery 新对象包含所有前面的同胞元素,但不包括由 .prevUntil() 方法规定的选择器匹配的那个元素;所返回元素的顺序是从最近的同胞元素到最远的那个。

如果不匹配或未应用选择器,则将选区所有前面的同胞元素;在这种情况下,该方法选取的元素与未提供选择器时的 .prevAll() 相同。

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

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