WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

`className` und `innerHTML`: Klassen und Inhalt eines Elements

`className` spiegelt das Attribut `class` wider. `innerHTML` liest den Inhalt als serialisiertes Markup oder parst Markup, um den Inhalt zu ersetzen.

Version: Current web platform; runtime support varies

Syntax

element.className;
htmlElement.className = classString;
element.innerHTML;
element.innerHTML = markup;

className und innerHTML sind zwei DOM-Instanzeigenschaften, keine Methoden oder Sprachmerkmale von ECMAScript. Sie werden von einer Laufzeitumgebung mit DOM bereitgestellt, nicht von der JavaScript-Engine allein.

Bei einem HTML-Element liest className das Attribut class als Zeichenkette (leer, wenn das Attribut fehlt). Eine Zuweisung ersetzt den gesamten Attributwert. Um eine einzelne Klasse hinzuzufügen, zu entfernen oder umzuschalten, ohne die anderen zu verwerfen, verwende classList.add(), remove() oder toggle(). Bei SVG-Elementen kann className statt einer Zeichenkette ein SVGAnimatedString-Objekt sein. Verwende für beide Elementarten getAttribute("class") und setAttribute("class", value), um den Attributtext zu lesen und zu schreiben. Fehlt das Attribut, liefert getAttribute() den Wert null.

Beim Lesen serialisiert innerHTML den Inhalt als HTML oder XML, ohne die Tags des Elements selbst und ohne Shadow Roots. Das Ergebnis muss nicht dem ursprünglichen Quelltext entsprechen. Eine Zuweisung parst ein Fragment im Kontext des Elements und ersetzt dessen Kindknoten; das Element selbst bleibt erhalten. Bei einem template wird stattdessen der Vorlageninhalt ersetzt. Die alten Knoten werden abgetrennt; Referenzen zeigen weiterhin auf sie, und ihre Ereignislistener gehen nicht auf die neuen Knoten über. In einem XML-Dokument löst ein nicht wohlgeformtes Fragment eine DOMException namens SyntaxError aus.

innerHTML bereinigt das Markup nicht. Eingefügte script-Elemente werden nicht ausgeführt, aber Ereignishandler-Attribute können weiterhin XSS ermöglichen. Verwende textContent für Klartext in einem gewöhnlichen Element. Wenn du nicht vertrauenswürdiges Markup benötigst, bereinige es zuerst. Erzwingt eine unterstützte CSP Trusted Types, löst die Zuweisung einer Zeichenkette ohne Standardrichtlinie einen TypeError aus. Stattdessen kannst du TrustedHTML aus einer Richtlinie übergeben, die die Eingabe bereinigt.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>className and innerHTML</title>
<script>
  const card = document.createElement("div");
  const oldChild = document.createElement("span");
  card.append(oldChild);

  card.className = "card draft";
  card.className = "card ready";
  console.log(card.className);
  console.log(oldChild.parentNode === card);

  card.innerHTML = "<strong>Ready</strong>";
  console.log(card.innerHTML);
  console.log(oldChild.parentNode === null);
</script>

Ergebnis

card ready
true
<strong>Ready</strong>
true

Speichere das Beispiel als `.html`-Datei, öffne sie im Browser und prüfe die Ausgaben in der Konsole. Das erste `true` zeigt, dass der alte Kindknoten beim Klassenwechsel erhalten bleibt; das zweite zeigt, dass die Zuweisung an `innerHTML` ihn abtrennt.

Zugehörige Lektionen

  • JavaScript · Lektion 11 · Fortgeschritten · Version: 4

Quellen