prevUntil()
获取每个元素但不包括选择器,DOM节点,或者jQuery对象匹配的元素的所有前面的兄弟元素。
.prevUntil([selector ][, filter ])
- selector类型: Selector。选择器字符串,用于确定到哪个排在前面的同辈元素时停止匹配
- filter类型: Selector。一个字符串,其中包含一个选择器表达式用来匹配的元素。
.prevUntil([element ][, filter ])
- elementType: Element or jQuery一个DOM节点或jQuery对象说明哪里开始停止匹配接下来的同级元素。
- filter类型: Selector。一个字符串,其中包含一个选择器表达式用来匹配的元素。
如果提供的jQuery代表了一组DOM元素,.prevUntil()
方法会找遍所有元素所在的DOM树中排在它们前面的元素,直到遇到了一个跟提供的参数匹配的元素的时候才会停下来。这个新jQuery对象里包含了前面所有找到的同辈元素,但不包括提供给.prevUntil()
的选择器匹配到的元素。返回的元素顺序是从最靠近的兄弟元素到最远的兄弟元素。
如果提供的选择器没有匹配到任何东西,或者干脆没有提供选择器,那么排在前面的所有同辈元素都会被选中。这就跟用没有提供参数的.prevAll()
效果一样。
从 jQuery 1.6 开始,一个DOM节点或jQuery对象,而不是一个选择器,可被传递到.prevUntil()
方法。
该方法选择性地接受一个选择器表达式作为它的第二个参数。如果提供此参数,将通过测试它们是否匹配过滤元素。
例子
找到前面<dt id="term-2">到前面<dt>之间的同级项,并为它们提供红色背景色。另外,找到<dt id="term-3">到<dt id="term-1">的上一个<dd>同级项,并为它们指定绿色文本颜色。
<!DOCTYPE html> <html> <head> <script src="https://www.lanmper.cn/static/js/jquery-3.5.0.js"></script> </head> <body> <dl> <dt id="term-1">term 1</dt> <dd>definition 1-a</dd> <dd>definition 1-b</dd> <dd>definition 1-c</dd> <dd>definition 1-d</dd> <dt id="term-2">term 2</dt> <dd>definition 2-a</dd> <dd>definition 2-b</dd> <dd>definition 2-c</dd> <dt id="term-3">term 3</dt> <dd>definition 3-a</dd> <dd>definition 3-b</dd> </dl> <script> $("#term-2").prevUntil("dt") .css("background-color", "red");var term1 = document.getElementById('term-1'); $("#term-3").prevUntil(term1, "dd") .css("color", "green"); </script> </body> </html>
- term 1
- definition 1-a
- definition 1-b
- definition 1-c
- definition 1-d
- term 2
- definition 2-a
- definition 2-b
- definition 2-c
- term 3
- definition 3-a
- definition 3-b