Metoda parentsUntil() przeglądania jQuery
Przykład
Znajdź przodków elementu <li class="item-a">, aż do <ul class="level-1">, i ustaw ich tło na czerwone. Jednocześnie, znajdź wszystkie przodki elementu <li class="item-2"> o nazwie klasy "yes", aż do <ul class="level-1">, i ustaw im błękitne ramki:
$("li.item-a");.parentsUntil(".level-1");
.css("background-color", "red");
$("li.item-2");.parentsUntil($("ul.level-1"), ".yes");
.css("border", "3px solid blue");
Definicja i użycie
Metoda parentsUntil() uzyskuje przodków każdego elementu w zbiorze elementów dopasowanych, aż do (ale nie włącznie z) elementu dopasowanego do wyboru, węzła DOM lub obiektu jQuery.
Gramatyka 1
.parentsUntil(selector,filter)
| Parametry | Opis |
|---|---|
| selector | Opcjonalne. Wartość ciągła, określająca, gdzie zakończyć dopasowywanie przodków. |
| filter | Opcjonalne. Wartość ciągła, zawierająca wyrażenie wyboru używane do dopasowywania elementów. |
Gramatyka 2
.parentsUntil(element,filter)
| Parametry | Opis |
|---|---|
| element | Opcjonalne. Węzeł DOM lub obiekt jQuery, wskazujący, gdzie zakończyć dopasowywanie przodków. |
| filter | Opcjonalne. Wartość ciągła, zawierająca wyrażenie wyboru używane do dopasowywania elementów. |
Szczegółowe wyjaśnienie
Jeśli podany jest obiekt jQuery reprezentujący zbiór elementów DOM, metoda .parentsUntil() pozwala na wyszukiwanie przodków tych elementów w drzewie DOM, aż do napotkania elementu pasującego do wyboru (przekazanego do metody). Zwracany obiekt jQuery zawiera wszystkich przodków, ale nie zawiera elementu pasującego do wyboru określonego przez metodę .parentsUntil().
Jeśli nie ma dopasowania lub wybór nie został zastosowany, wszystkie przodkowie elementów będą wybrane; w tym przypadku, elementy wybrane przez metodę są takie same jak te wybrane przez .parents() bez wyboru.
Dla jQuery 1.6, węzły DOM lub obiekty jQuery, a nie wybór, mogą być używane jako pierwszy parametr metody .parentsUntil().
Ta metoda akceptuje opcjonalny wyrażenie wyboru jako drugi parametr. Jeśli zastosujemy ten parametr, elementy będą filtrowane poprzez sprawdzanie, czy pasują do tego wyboru.
