DOMTokenList

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

DOMTokenList.length (en-US) Read only

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

DOMTokenList.value (en-US)

Il valore della lista come una DOMString.

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() (en-US)

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

DOMTokenList.add() (en-US)

Aggiunge il token indicato alla lista.

DOMTokenList.remove() (en-US)

Rimuove il token specificato dall'elenco.

DOMTokenList.replace() (en-US)

Sostituisce un token esistente con un nuovo token.

DOMTokenList.supports() (en-US)

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

DOMTokenList.toggle() (en-US)

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

DOMTokenList.entries() (en-US)

Restituisce un iterator (en-US) consentendoti di passare attraverso tutte le coppie chiave/valore contenute in questo oggetto.

DOMTokenList.forEach() (en-US)

Esegue una funzione fornita una volta per elemento DOMTokenList.

DOMTokenList.keys() (en-US)

Restituisce un iterator (en-US) consentendo di esaminare tutte le chiavi delle coppie chiave/valore contenute in questo oggetto.

DOMTokenList.values() (en-US)

Restituisce un iterator (en-US) consentendo di esaminare tutti i valori delle coppie chiave/valore contenute in questo oggetto.

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() (en-US), 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:

I metodi che modificano DOMTokenList (come DOMTokenList.add() (en-US)) 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:

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