Metodo prevUntil() di jQuery Navigazione
Esempio
Cerca gli elementi gemelli precedenti di <dt id="term-2"> fino al <dt> precedente, e li imposta a rosso. Allo stesso tempo, cerca gli elementi gemelli precedenti <dd> di <dt id="term-3"> fino a <dt id="term-1">, e li imposta a testo blu:
$("#term-2").prevUntil("dt").css("background-color", "red");
var term1 = document.getElementById('term-1');
$("#term-3").prevUntil(term1, "dd").css("color", "green");
Definizione e uso
Il metodo prevUntil() ottiene gli elementi gemelli precedenti di ogni elemento nella raccolta corrente di corrispondenze jQuery, ma non include l'elemento che corrisponde al selettore, al nodo DOM o all'oggetto jQuery.
Sintassi 1
.prevUntil(selector, filter)
| Parametro | Descrizione |
|---|---|
| selector | Opzionale. Valore di stringa, che contiene l'espressione di selettore che indica dove fermare la ricerca degli elementi gemelli precedenti. |
| filter | Opzionale. Valore di stringa, che contiene l'espressione di selettore utilizzata per abbinare gli elementi. |
Sintassi 2
.prevUntil(element, filter)
| Parametro | Descrizione |
|---|---|
| element | Opzionale. Indica il nodo DOM o l'oggetto jQuery dove fermare la ricerca degli elementi gemelli precedenti. |
| 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 .prevUntil() ci permette di cercare gli elementi gemelli precedenti in questo albero DOM fino a quando non si incontra un elemento che corrisponde al selettore (passato come parametro al metodo). L'oggetto jQuery nuovo restituito contiene tutti gli elementi gemelli precedenti, ma non include l'elemento che corrisponde al selettore specificato dal metodo .prevUntil(); l'ordine degli elementi restituiti è dal gemello più vicino a quello più lontano.
Se non corrisponde o non viene applicato il selettore, vengono selezionati tutti gli elementi gemelli precedenti; in questo caso, gli elementi selezionati sono gli stessi di .prevAll() senza selettore.
Per jQuery 1.6, un nodo DOM o un oggetto jQuery, invece del selettore, possono essere utilizzati come primo parametro del metodo .prevUntil().
Questo metodo accetta un'espressione di selettore opzionale come secondo parametro. Se viene applicato questo parametro, gli elementi vengono filtrati in base al fatto che corrispondano o meno al selettore.
