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.

Proprietà

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.

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() (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.

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() (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:

Taglio di spazi bianchi e rimozione di duplicati

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:

Specificazioni

Specificazione Stato Commento
DOM
The definition of 'DOMTokenList' in that specification.
Living Standard Initial definition

Compatibilità con i browser

BCD tables only load in the browser

Guarda anche