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