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, altrimentifalse
. 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
DOMSettableTokenList
(oggetto che estendeDOMTokenList
con la proprietà settabile .value)