nextUntil()

.nextUntil( [selector,] [filter] )

Returns: jQuery

Description: Get all following siblings of each element up to but not including the element matched by the selector, DOM node, or jQuery object passed.

.nextUntil( [selector,] [filter] )

version added: 1.4

selector

String

A string containing a selector expression to indicate where to stop matching following sibling elements.

filter

String

A string containing a selector expression to match elements against.

.nextUntil( [element,] [filter] )

version added: 1.6

element

Object, DOM node

A DOM node or jQuery object indicating where to stop matching following sibling elements.

filter

String

A string containing a selector expression to match elements against.

Given a jQuery object that represents a set of DOM elements, the .nextUntil() method allows us to search through the successors of these elements in the DOM tree, stopping when it reaches an element matched by the method's argument. The new jQuery object that is returned contains all following siblings up to but not including the one matched by the .nextUntil() selector.

If the selector is not matched or is not supplied, all following siblings will be selected; in these cases it selects the same elements as the .nextAll() method does when no filter selector is provided.

As of jQuery 1.6, A DOM node or jQuery object, instead of a selector, may be passed to the .nextUntil() method.

The method optionally accepts a selector expression for its second argument. If this argument is supplied, the elements will be filtered by testing whether they match it.

Consider a page with a simple definition list as follows:

<dl>
  <dt>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>term 3</dt>
  <dd>definition 3-a</dd>
  <dd>definition 3-b</dd>
</dl>

If we begin at the second term, we can find the elements which come after it until a following <dt>.

$('#term-2').nextUntil('dt').css('background-color', 'red');

The result of this call is a red background behind definitions 2-a, 2-b, and 2-c.

Example

Find the siblings that follow <dt id="term-2"> up to the next <dt> and give them a red background color.

$("#term-2").nextUntil("dt").css("background-color", "red");

The output of the code above will be:

Try it yourself

Example - Full source:

Find the siblings that follow <dt id="term-2"> up to the next <dt> and give them a red background color.

<!DOCTYPE html>
<html>
<head>
<script src="http://code.jquery.com/jquery-latest.js"></script>
  <script type="text/javascript" language="javascript">
   $(document).ready(function(){
      $("#term-2").nextUntil("dt").css("background-color", "red");
   });
  </script>
</head>
<body>
	<dl>

  <dt>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>term 3</dt>
  <dd>definition 3-a</dd>
  <dd>definition 3-b</dd>

</dl>
</body>
</html>

Try it yourself

Was this information helpful?

Yes No

nextUntil()

.nextUntil( [selector,] [filter] )

.nextUntil( [selector,] [filter] )

.nextUntil( [element,] [filter] )

Example

Example - Full source:

Comments