Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
DOMTokenList
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die SchnittstelleDOMTokenList repräsentiert eine Menge von durch Leerzeichen getrennten Tokens. Eine solche Menge wird vonElement.classList oderHTMLLinkElement.relList und vielen anderen zurückgegeben.
EinDOMTokenList ist beginnend mit0 indiziert, wie bei JavaScript-Array-Objekten.DOMTokenList ist immer fallunterscheidend.
In diesem Artikel
Instanz-Eigenschaften
DOMTokenList.lengthSchreibgeschütztEine
integer, die die Anzahl der im Objekt gespeicherten Objekte darstellt.DOMTokenList.valueEinestringifier-Eigenschaft, die den Wert der Liste als Zeichenkette zurückgibt.
Instanz-Methoden
DOMTokenList.item()Gibt das Element in der Liste anhand seines Indexes zurück oder
null, wenn der Index größer oder gleich derlengthder Liste ist.DOMTokenList.contains()Gibt
truezurück, wenn die Liste das angegebene Token enthält, andernfallsfalse.DOMTokenList.add()Fügt der Liste die angegebenen Tokens hinzu.
DOMTokenList.remove()Entfernt die angegebenen Tokens aus der Liste.
DOMTokenList.replace()Ersetzt das Token durch ein anderes.
DOMTokenList.supports()Gibt
truezurück, wenn das angegebene Token zu den unterstützten Tokens des zugehörigen Attributs gehört.DOMTokenList.toggle()Entfernt das Token aus der Liste, wenn es existiert, oder fügt es hinzu, wenn es nicht existiert. Gibt einen booleschen Wert zurück, der angibt, ob das Token nach der Operation in der Liste ist.
DOMTokenList.entries()Gibt eineniterator zurück, der es ermöglicht, alle Schlüssel/Wert-Paare in diesem Objekt durchzugehen.
DOMTokenList.forEach()Führt eine bereitgestellte Callback-Funktion einmal für jedes Element des
DOMTokenListaus.DOMTokenList.keys()Gibt eineniterator zurück, der es ermöglicht, alle Schlüssel der Schlüssel/Wert-Paare in diesem Objekt durchzugehen.
DOMTokenList.toString()Gibt den
DOMTokenList.valuezurück, die als Zeichenkette durch Leerzeichen getrennten Werte der Liste.DOMTokenList.values()Gibt eineniterator zurück, der es ermöglicht, alle Werte der Schlüssel/Wert-Paare in diesem Objekt durchzugehen.
Beispiele
Im folgenden einfachen Beispiel rufen wir die Liste von Klassen ab, die auf einem<p>-Element alsDOMTokenList gesetzt sind, fügen eine Klasse mitDOMTokenList.add() hinzu und aktualisieren anschließend denNode.textContent des<p>, um demDOMTokenList gleichzusetzen.
Zuerst das HTML:
<p></p>Jetzt das #"p");let classes = para.classList;para.classList.add("d");para.textContent = `paragraph classList is "${classes}"`;
Die Ausgabe sieht so aus:
Kürzen von Leerzeichen und Entfernen von Duplikaten
Methoden, die dasDOMTokenList modifizieren (wieDOMTokenList.add()), kürzen automatisch überschüssigeLeerzeichen und entfernen doppelte Werte aus der Liste. Zum Beispiel:
<span></span>let span = document.querySelector("span");let classes = span.classList;span.classList.add("x");span.textContent = `span classList is "${classes}"`;Die Ausgabe sieht so aus:
Spezifikationen
| Specification |
|---|
| DOM> # interface-domtokenlist> |