.nextUntil()

.nextUntil( [selector ] [, filter ] )Возвращает: jQuery

Описание: Получить все последующие соседние элементы каждого элемента до, но не включая, элемент, соответствующий переданному селектору, узлу DOM или объекту jQuery.

версия добавлена: 1.4.nextUntil( [selector ] [, filter ] )
- selector
  
  Тип: Селектор
  
  Строка, содержащая выражение селектора, указывающее, где следует прекратить сопоставление последующих соседних элементов.
- filter
  
  Тип: Селектор
  
  Строка, содержащая выражение селектора для сопоставления элементов.
версия добавлена: 1.6.nextUntil( [element ] [, filter ] )
- element
  
  Тип: Элемент или jQuery
  
  Узел DOM или объект jQuery, указывающий, где следует прекратить сопоставление последующих соседних элементов.
- filter
  
  Тип: Селектор
  
  Строка, содержащая выражение селектора для сопоставления элементов.

При заданном выражении селектора, представляющем набор элементов DOM, метод .nextUntil() проходит по потомкам этих элементов в дереве DOM, останавливаясь, когда достигает элемента, соответствующего аргументу метода. Новый объект jQuery, который возвращается, содержит все последующие соседние элементы до, но не включая, элемент, соответствующий аргументу .nextUntil().

Если селектор не найден или не указан, будут выбраны все последующие соседние элементы; в этих случаях он выбирает те же элементы, что и метод .nextAll() при отсутствии селектора фильтра.

Начиная с jQuery 1.6, в метод .nextUntil() можно передать узел DOM или объект jQuery вместо селектора.

Метод необязательно принимает выражение селектора в качестве второго аргумента. Если этот аргумент указан, элементы будут отфильтрованы путем проверки на соответствие ему.

Пример:

Найти соседние элементы, следующие за <dt id="term-2"> до следующего <dt> и задать им красный цвет фона. Также, найти <dd> элементы, следующие за <dt id="term-1"> до <dt id="term-3"> и задать им зелёный цвет текста.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>nextUntil demo</title>
  <script src="https://code.jquery.com/jquery-3.7.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" )
  .nextUntil( "dt" )
    .css( "background-color", "red" );
var term3 = document.getElementById( "term-3" );
$( "#term-1" )
  .nextUntil( term3, "dd" )
    .css( "color", "green" );
</script>
 
</body>
</html>

.nextUntil( [selector ] [, filter ] )Возвращает: jQuery

версия добавлена: 1.4.nextUntil( [selector ] [, filter ] )

версия добавлена: 1.6.nextUntil( [element ] [, filter ] )

Пример:

Демо: