.nextUntil()
返回: jQuery
.nextUntil( [selector ] [, filter ] )
描述:获得每个元素所有后面的同辈元素,向后直到遇到匹配选择器、DOM节点或者jQuery对象的那个元素(但是不包含这个匹配的元素)。
给定一个jQuery对象,代表了一个DOM元素的集合,.nextUntil()
方法允许我们搜索遍DOM树中这些元素后面的同辈元素,直到它达到一个匹配方法的参数的元素才停止。返回的新的jQuery对象包含了所有的后面的同辈元素,直到但是不包括.nextUntil()
的参数匹配到的那个元素。
如果没有提供该选择器或者提供了但是没匹配到,则所有后面跟着的同辈元素都会被选中;那样的话,它就和不提供筛选选择器的.nextAll()
方法选择了同样的元素。
自从jQuery 1.6,1个DOM节点或者jQuery对象,代替了一个选择器,可能传递给.nextUntil()
方法。
该方法可以视情况接受一个选择器表达式作为它的第二个参数。如果提供了该参数,将筛选元素,测试它们是否匹配该选择器。
示例
找到跟在<dt id="term-2">后面的直到下一个<dt>的同辈元素,并给它们红色背景。还要找到跟在<dt id="term-1">后面、直到<dt id="term-3">的<dd>同辈元素,给它们绿色的文本颜色。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>nextUntil demo</title> <script src="https://code.jquery.com/jquery-1.10.2.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" ) .nextUntil( "dt" ) .css( "background-color", "red" ); var term3 = document.getElementById( "term-3" ); $( "#term-1" ) .nextUntil( term3, "dd" ) .css( "color", "green" ); </script> </body> </html>
演示结果