CKTIS / JavaScript
Element: Klassen, Inhalt und Attributpräsenz
Mit `className` liest oder ersetzt du die Klassenzeichenfolge, mit `innerHTML` den Inhalt als Markup, und mit `toggleAttribute()` änderst du, ob ein Attribut vorhanden ist.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.className
element.className = classNames
element.innerHTML
element.innerHTML = markup
element.toggleAttribute(name)
element.toggleAttribute(name, force)Das sind DOM-APIs, keine Funktionen von ECMAScript 2024. Die in diesem Eintrag genannte ECMAScript-Version sagt nichts über ihre Verfügbarkeit aus. Sie setzen eine Umgebung voraus, die die entsprechenden DOM-APIs bereitstellt; die Unterstützung hängt von der Laufzeitumgebung ab.
Bei einem HTML-Element spiegelt className das Attribut class als Zeichenfolge mit durch Leerraum getrennten Klassennamen wider. Eine Zuweisung ersetzt die gesamte Zeichenfolge. Um eine einzelne Klasse zu ändern, ohne die anderen anzutasten, verwende classList. Bei SVG-Elementen kann className ein SVGAnimatedString sein. Mit getAttribute('class') oder setAttribute('class', value) greifst du direkt auf das Attribut zu.
Beim Lesen liefert innerHTML den Inhalt als HTML- oder XML-Markup, ohne das Element selbst und seine Shadow Root. Beim Setzen wird das Markup im Kontext des Elements geparst und ersetzt die vorhandenen Inhaltsknoten, statt weitere anzuhängen. Bei template wird der Vorlageninhalt ersetzt. Ereignis-Listener bleiben an den alten Knoten und werden nicht auf die neuen übertragen. In einem XML-Dokument kann nicht wohlgeformtes Markup beim Schreiben SyntaxError auslösen; scheitert die Serialisierung beim Lesen, kann InvalidStateError auftreten.
Übergib nicht vertrauenswürdiges Markup nicht direkt an innerHTML: Es wird standardmäßig nicht bereinigt, wodurch ein XSS-Risiko entsteht. Verwende textContent, um reinen Text in Elementen wie span anzuzeigen. Weise textContent eines script-Elements jedoch keinen nicht vertrauenswürdigen Text zu: Beim Einfügen des Elements in das Dokument kann der Text als Code ausgeführt werden. Wenn du Markup brauchst, bereinige nicht vertrauenswürdige Eingaben vor dem Einfügen. Erzwingt die CSP Trusted Types und fehlt eine Standardrichtlinie, löst die Zuweisung einer gewöhnlichen Zeichenfolge TypeError aus; verwende TrustedHTML aus einer geeigneten Richtlinie.
toggleAttribute(name) entfernt ein vorhandenes Attribut oder fügt ein fehlendes mit leerem Wert hinzu. Mit force stellt true die Präsenz sicher, ohne einen vorhandenen Wert zu ändern, und false stellt sicher, dass das Attribut fehlt. Der boolesche Rückgabewert zeigt, ob das Attribut danach vorhanden ist, nicht ob sich etwas geändert hat. Bei einem booleschen HTML-Attribut wie disabled hebt selbst der Wert "false" die Wirkung nicht auf: Entscheidend ist die Präsenz. Bei einem HTML-Element in einem HTML-Dokument werden ASCII-Buchstaben im Namen kleingeschrieben; ein ungültiger Name löst InvalidCharacterError aus.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element DOM example</title>
</head>
<body>
<script>
(() => {
const button = document.createElement('button');
button.className = 'action muted';
button.className = 'action ready';
button.innerHTML = '<span>Draft</span>';
const oldLabel = button.firstElementChild;
button.innerHTML = '<strong>Save</strong>';
console.log(button.className);
console.log(button.innerHTML);
console.log(oldLabel.parentNode === null);
console.log(button.toggleAttribute('disabled'));
console.log(button.toggleAttribute('disabled', true));
console.log(button.toggleAttribute('disabled', false));
})();
</script>
</body>
</html>Ergebnis
action ready <strong>Save</strong> true true true false
Speichere das Beispiel als HTML-Datei, öffne sie in einem Browser ohne erzwungene Trusted Types und sieh dir die Ausgabe in der Entwicklerkonsole an. Die Schaltfläche wird nicht ins Dokument eingefügt. Das erste `true` bestätigt, dass der alte Beschriftungsknoten entfernt wurde; die letzten drei Ergebnisse zeigen den Zustand von `disabled` nach dem Hinzufügen, Sicherstellen der Präsenz und Entfernen.
Zugehörige Lektionen
- JavaScript · Lektion 39 · Mittlere Stufe · Version: 3