DOMTokenList

L'interfaccia DOMTokenList rappresenta un insieme di token separati dallo spazio. Tale insieme viene restituito da Element.classList, HTMLLinkElement.relList, HTMLAnchorElement.relList, HTMLAreaElement.relList, HTMLIframeElement.sandbox, o HTMLOutputElement.htmlFor. Viene indicizzato a partire da 0 come con gli JavaScript Array oggetti. DOMTokenList è sempre case-sensitive.

Proprietà

DOMTokenList.length Read only

È un integer che rappresenta il numero di oggetti memorizzati nell'oggetto.

DOMTokenList.value

Il valore della lista come una DOMString.

Metodi

DOMTokenList.item()

Restituisce un elemento nell'elenco per il suo indice (restituisce undefined se il numero è maggiore o uguale alla lunghezza dell'elenco).

DOMTokenList.contains()

Restituisce true se la lista contiene il token dato, altrimenti false.

DOMTokenList.add()

Aggiunge il token indicato alla lista.

DOMTokenList.remove()

Rimuove il token specificato dall'elenco.

DOMTokenList.replace()

Sostituisce un token esistente con un nuovo token.

DOMTokenList.supports()

Restituisce true se un determinato token si trova nei token supportati dell'attributo associato.

DOMTokenList.toggle()

Rimuove un determinato token dall'elenco e restituisce false. Se il token non esiste viene aggiunto e la funzione restituisce true.

DOMTokenList.entries()

Restituisce un iterator consentendoti di passare attraverso tutte le coppie chiave/valore contenute in questo oggetto.

DOMTokenList.forEach()

Esegue una funzione fornita una volta per elemento DOMTokenList.

DOMTokenList.keys()

Restituisce un iterator consentendo di esaminare tutte le chiavi delle coppie chiave/valore contenute in questo oggetto.

DOMTokenList.values()

Restituisce un iterator consentendo di esaminare tutti i valori delle coppie chiave/valore contenute in questo oggetto.

Esempi

Nel seguente semplice esempio, recuperiamo l'elenco di classi impostato su un elemento <p> come una DOMTokenList usando Element.classList, aggiungi una classe usando DOMTokenList.add(), quindi aggiorna il Node.textContent di <p> per uguagliare DOMTokenList.

Innanzitutto, l'HTML:

<p class="a b c"></p>

Ora JavaScript:

var para = document.querySelector("p");
var classes = para.classList;
para.classList.add("d");
para.textContent = 'paragraph classList is "' + classes + '"';

L'output è simile a questo:

Taglio di spazi bianchi e rimozione di duplicati

I metodi che modificano DOMTokenList (come DOMTokenList.add()) tagliano automaticamente gli spazi bianchi in eccesso e rimuovono i valori duplicati dall'elenco. Per esempio:

<span class="    d   d e f"></span>

var span = document.querySelector("span");
var classes = span.classList;
span.classList.add("x");
span.textContent = 'span classList is "' + classes + '"';

L'output è simile a questo:

Specificazioni

Compatibilità con i browser

Guarda anche

• DOMSettableTokenList (oggetto che estende DOMTokenList con la proprietà settabile .value)