Metoda nextUntil() jQuery - przegląd

Przegląd podręcznika jQuery

Przykład

Znajdź następujące rodzeństwa po <dt id="term-2">, aż do następnego <dt>, i ustaw je na czerwony kolor tła. Jednocześnie, znajdź następujące rodzeństwa <dd> po <dt id="term-1">, aż do <dt id="term-3">, i ustaw im kolor tekstu na niebieski.

$("#term-2").nextUntil("dt").css("background-color", "red");
var term3 = document.getElementById("term-3");
$("#term-1").nextUntil(term3, "dd").css("color", "blue");

Spróbuj sam

Definicja i użycie

nextUntil() uzyskuje wszystkie następujące rodzeństwa każdego elementu, ale nie zawiera elementów dopasowanych do wyrażenia selekcyjnego, węzła DOM lub przekazanego obiektu jQuery.

Gramatyka 1

.nextUntil(selector,filter)
Parametr Opis
selector Wartość ciągła, zawierająca wyrażenie selekcyjne wskazujące, gdzie ma zatrzymać się dopasowywanie następujących rodzeństw elementów.
filter Wartość ciągła, zawierająca wyrażenie selekcyjne używane do dopasowywania elementów.

Gramatyka 2

.nextUntil(element,filter)
Parametr Opis
element Wskaźnik, w którym ma zatrzymać się dopasowywanie następujących rodzeństw elementów, węzeł DOM lub obiekt jQuery.
filter Wartość ciągła, zawierająca wyrażenie selekcyjne używane do dopasowywania elementów.

Szczegółowe wyjaśnienie

Jeśli podano obiekt jQuery reprezentujący kolekcję elementów DOM, metoda .nextUntil() pozwala na wyszukiwanie następujących rodzeństw elementów w drzewie DOM, zatrzymując wyszukiwanie, gdy napotkane są elementy pasujące do parametrów tej metody. Nowy obiekt jQuery zawiera wszystkie następujące rodzeństwa, ale nie zawiera elementów pasujących do parametrów.

Jeśli wyrażenie selekcyjne nie pasuje lub nie określono wyrażenia selekcyjnego, będą wybrane wszystkie następujące rodzeństwa; jeśli nie dostarczono wyrażenia do filtrowania, elementy wybrane przez tą metodę będą takie same jak metodą .nextAll().

Dla jQuery 1.6, węzły DOM lub obiekty jQuery, zamiast wyrażenia selekcyjnego, mogą być przekazywane do metody .nextUntil().

Ta metoda akceptuje opcjonalny wyrażenie selekcyjne jako drugi parametr. Jeśli określono ten parametr, elementy będą filtrowane poprzez sprawdzanie, czy pasują do tego wyrażenia.

Przegląd podręcznika jQuery