CKTIS / JavaScript
Element.innerHTML und Element.className
Mit `innerHTML` liest oder ersetzt du den Inhalt eines Elements. Mit `className` liest oder setzt du seine CSS-Klassen.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.innerHTML;
element.innerHTML = markup;
element.className;
element.className = classNames;innerHTML und className sind zwei getrennte Eigenschaften von DOM-Instanzen, keine Methoden. Sie gehören zur Webplattform, nicht zu ECMAScript 2024: Eine JavaScript-Laufzeit ohne DOM stellt sie nicht bereit.
Beim Lesen liefert element.innerHTML den aktuell enthaltenen Markup-Code als Zeichenkette, ohne die Tags des Elements selbst und ohne Shadow Roots. Beim Zuweisen wird je nach Dokument ein HTML- oder XML-Fragment geparst. Die neuen Knoten ersetzen die Kindknoten, nicht das Element selbst. Auch identisches Markup erzeugt neue Knoten: Alte Referenzen zeigen weiter auf die entfernten Knoten, und deren Ereignis-Listener werden nicht übertragen. Bei einem template ersetzt die Zuweisung die Kindknoten des DocumentFragment, auf das content verweist, nicht das Fragment selbst. null wirkt wie "". In einem XML-Dokument löst ein nicht wohlgeformtes Fragment SyntaxError aus; schlägt die Serialisierung fehl, kann InvalidStateError auftreten. Beides sind Namen von DOMException.
Bei HTML-Elementen spiegelt element.className das Attribut class als eine Zeichenkette mit durch Leerraum getrennten Namen wider. Eine Zuweisung ersetzt den gesamten Attributwert, ohne die Kindknoten zu ändern. Ändere eine einzelne Klasse mit classList.add(), classList.remove() oder classList.toggle(), damit die übrigen erhalten bleiben. Bei SVG-Elementen kann className ein SVGAnimatedString sein. Verwende dort getAttribute("class") oder setAttribute("class", value), um das gesamte Attribut zu lesen oder zu setzen. getAttribute() liefert null, wenn das Attribut fehlt, und "", wenn es vorhanden, aber leer ist.
innerHTML bereinigt Eingaben standardmäßig nicht. Weise deshalb keine nicht vertrauenswürdigen Eingaben direkt zu: Das kann zu Cross-Site-Scripting (XSS) führen. Verwende für reinen Text in einem gewöhnlichen Element textContent; der Text wird dann nicht als HTML geparst. Bereinige benötigtes Markup aus nicht vertrauenswürdigen Quellen zuerst. Wenn Trusted Types unterstützt wird, kann eine Richtlinie bereinigte Inhalte als TrustedHTML zurückgeben; der Typ selbst bereinigt nichts. Erzwingt die CSP Trusted Types und ist keine Standardrichtlinie vorhanden, löst die Zuweisung einer Zeichenkette TypeError aus.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>innerHTML and className</title>
</head>
<body>
<script>
{
const card = document.createElement("div");
card.className = "card muted";
card.innerHTML = "<strong>Ready</strong>";
const original = card.firstElementChild;
card.className = "card active";
card.classList.add("highlight");
console.log(card.className);
console.log(card.firstElementChild === original);
card.innerHTML = "<strong>Ready</strong>";
console.log(card.firstElementChild === original);
console.log(card.innerHTML);
}
</script>
</body>
</html>Ergebnis
card active highlight true false <strong>Ready</strong>
Speichere das vollständige Beispiel als HTML-Datei und öffne es im Browser, ohne dass eine CSP Trusted Types erzwingt. Die Ausgabe erscheint in der Browserkonsole. Das Element bleibt außerhalb des Dokuments. Die Klassenänderung lässt den Kindknoten bestehen; die Zuweisung von identischem HTML ersetzt ihn.
Zugehörige Lektionen
- JavaScript · Lektion 42 · Mittlere Stufe · Version: 3