Metoda prevUntil() jQuery do przeglądania

Podręcznik do przeglądania jQuery

Przykład

Znajdź poprzedzające rodzeństwa <dt id="term-2">, aż do poprzedniego <dt>, i ustaw je na czerwony. Jednocześnie, znajdź poprzedzające rodzeństwa <dd> przed <dt id="term-1">, i ustaw je na niebieski tekst:

$("#term-2").prevUntil("dt").css("background-color", "red");
var term1 = document.getElementById('term-1');
$("#term-3").prevUntil(term1, "dd").css("color", "green");

Spróbuj sam

Definicja i zastosowanie

Metoda prevUntil() uzyskuje poprzedzające rodzeństwa każdego elementu w bieżącej kolekcji dopasowanych elementów, ale nie zawiera elementów dopasowanych do wyrażenia, węzłów DOM lub obiektów jQuery.

Gramatyka 1

.prevUntil(selector, filter)
Parametry Opis
selector Opcjonalne. Wartość ciągła, zawierająca wyrażenie selekcyjne do zakończenia dopasowywania poprzedzających rodzeństw.
filter Opcjonalne. Wartość ciągła, zawierająca wyrażenie selekcyjne do dopasowania elementów.

Gramatyka 2

.prevUntil(element, filter)
Parametry Opis
element Opcjonalne. Wskazuje, gdzie zakończyć dopasowywanie poprzedzających rodzeństw węzłów DOM lub obiektów jQuery.
filter Opcjonalne. Wartość ciągła, zawierająca wyrażenie selekcyjne do dopasowania elementów.

Szczegółowe wyjaśnienie

Jeśli podano obiekt jQuery reprezentujący kolekcję elementów DOM, metoda .prevUntil() pozwala na wyszukiwanie poprzedzających rodzeństw tych elementów w drzewie DOM, aż do napotkania elementu dopasowanego do wyrażenia selekcyjnego (przekazanego do metody jako parametr). Zwracany nowy obiekt jQuery zawiera wszystkie poprzedzające rodzeństwa elementów, ale nie zawiera elementu dopasowanego do wyrażenia przez metodę .prevUntil(); kolejność zwracanych elementów jest od najbliższego rodzeństwa do najdalszego.

Jeśli nie ma dopasowania lub nie zastosowano wyrażenia selekcyjnego, wybiera wszystkie poprzedzające rodzeństwa elementów; w tym przypadku wybierane elementy są takie same jak w przypadku .prevAll() bez podanego wyrażenia.

Dla jQuery 1.6, węzły DOM lub obiekty jQuery, zamiast wyrażenia selekcyjnego, mogą być używane jako pierwszy parametr metody .prevUntil().

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

Podręcznik do przeglądania jQuery