Metodo nextUntil() di jQuery
Esempio
Cerca gli elementi fratelli seguenti di <dt id="term-2"> fino al prossimo <dt>, e imposta il loro sfondo a colore rosso. Allo stesso tempo, trova gli elementi fratelli <dd> seguenti di <dt id="term-1"> fino a <dt id="term-3">, e imposta il loro colore del testo a blu.
$("#term-2").nextUntil("dt").css("background-color", "red");
var term3 = document.getElementById("term-3");
$("#term-1").nextUntil(term3, "dd").css("color", "blue");
Definizione e uso
nextUntil() ottiene tutti gli elementi fratelli seguenti di ogni elemento, ma non quelli abbinati dal selettore, dal nodo DOM o dall'oggetto jQuery passato.
Sintassi 1
.nextUntil(selector,filter)
| Parametro | Descrizione |
|---|---|
| selector | Valore di stringa, che contiene l'espressione di selettore utilizzata per indicare dove fermare la corrispondenza degli elementi fratelli seguenti. |
| filter | Valore di stringa, che contiene l'espressione di selettore utilizzata per abbinare gli elementi. |
Sintassi 2
.nextUntil(element,filter)
| Parametro | Descrizione |
|---|---|
| element | Indica il punto in cui fermare la corrispondenza degli elementi fratelli seguenti il nodo DOM o l'oggetto jQuery. |
| filter | 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 .nextUntil() ci permette di cercare gli elementi fratelli seguenti nell'albero DOM, che si ferma quando incontra l'elemento che corrisponde ai parametri del metodo. L'oggetto jQuery nuovo restituito contiene tutti gli elementi fratelli seguenti, ma non quelli corrispondenti ai parametri.
Se il selettore non corrisponde o non è definito, vengono selezionati tutti i fratelli seguenti; se non viene fornito un selettore da filtrare, gli elementi selezionati da questo metodo sono gli stessi di .nextAll().
Per jQuery 1.6, è possibile passare un nodo DOM o un oggetto jQuery a .nextUntil() invece del selettore.
Questo metodo accetta un'espressione di selettore opzionale come secondo parametro. Se viene specificato questo parametro, viene filtrato il selettore per verificare se corrisponde agli elementi.
