Metodo parentsUntil() di esplorazione jQuery
Esempio
Cerca gli elementi antenati di <li class="item-a"> fino a <ul class="level-1"> e imposta il loro sfondo a colore rosso. Trova anche tutti gli elementi antenati di <li class="item-2"> con la classe "yes" fino a <ul class="level-1"> e assegna loro un bordo azzurro:
$("li.item-a");.parentsUntil(".level-1");
.css("background-color", "red");
$("li.item-2");.parentsUntil($("ul.level-1"), ".yes");
.css("border", "3px solid blue");
Definizione e uso
Il metodo parentsUntil() ottiene gli elementi antenati di ciascun elemento nella raccolta di corrispondenze corrente, fino a (ma non inclusi) l'elemento che corrisponde al selettore, al nodo DOM o all'oggetto jQuery.
Sintassi 1
.parentsUntil(selector,filter)
| Parametro | Descrizione |
|---|---|
| selector | Opzionale. Valore di stringa, che specifica dove fermarsi nella corrispondenza degli elementi antenati. |
| filter | Opzionale. Valore di stringa, che contiene l'espressione di selettore utilizzata per abbinare gli elementi. |
Sintassi 2
.parentsUntil(element,filter)
| Parametro | Descrizione |
|---|---|
| element | Opzionale. Nodo DOM o oggetto jQuery, che indica dove fermarsi nella corrispondenza degli elementi antenati. |
| filter | Opzionale. Valore di stringa, che contiene l'espressione di selettore utilizzata per abbinare gli elementi. |
Descrizione dettagliata
Se viene fornito un oggetto jQuery che rappresenta un insieme di elementi DOM, il metodo .parentsUntil() permette di cercare gli elementi antenati di questi elementi nelbero dell'albero DOM, fino a quando non si incontra un elemento che corrisponde al selettore (passato come parametro al metodo). L'oggetto jQuery restituito contiene tutti gli elementi antenati, ma non include l'elemento che corrisponde al selettore specificato da .parentsUntil().
Se non corrisponde o non viene applicato il selettore, vengono selezionati tutti gli elementi antenati; in questo caso, gli elementi selezionati dal metodo .parentsUntil() sono gli stessi di quelli selezionati da .parents() senza selettore.
Per jQuery 1.6, il nodo DOM o l'oggetto jQuery, piuttosto che il selettore, possono essere utilizzati come primo parametro del metodo .parentsUntil().
Questo metodo accetta un'espressione di selettore opzionale come suo secondo parametro. Se applicato questo parametro, gli elementi vengono filtrati tramite il controllo di corrispondenza con il selettore.
