WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element.innerHTML, tagName und namespaceURI

Lies und ersetze das Markup eines DOM-Elements und unterscheide Elemente anhand ihres lokalen Namens und Namensraums, wenn HTML und SVG im selben DOM-Baum vorkommen.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

element.innerHTML
 element.innerHTML = markup
 element.tagName
 element.namespaceURI

innerHTML liefert den aktuellen Inhalt des Elements als serialisierte Zeichenkette, ohne die Tags des Elements selbst und ohne Shadow Roots. Eine zugewiesene Zeichenkette oder ein Wert vom Typ TrustedHTML wird im Kontext des Elements als Fragment geparst und ersetzt seine Kindknoten, nicht das Element selbst. Verweise auf alte Knoten zeigen weiterhin auf diese Objekte, nicht auf die neuen Knoten. Bei einem HTML-Element template beziehen sich Lesen und Schreiben auf dessen content. null entspricht einer leeren Zeichenkette.

Ein HTML-Dokument verwendet den HTML-Parser, der fehlerhaftes Markup korrigieren kann. Ein XML-Dokument, einschließlich als XML ausgeliefertem XHTML, verwendet den XML-Parser. Ein nicht wohlgeformtes Fragment löst eine DOMException namens SyntaxError aus.

tagName ist der schreibgeschützte qualifizierte Name, gegebenenfalls mit Präfix. Nur bei Elementen im HTML-Namensraum in einem HTML-Dokument werden ASCII-Kleinbuchstaben in Großbuchstaben umgewandelt. Auch namespaceURI ist schreibgeschützt: Die Eigenschaft liefert die bei der Erstellung festgelegte Namensraum-URI oder null, wenn kein Namensraum vorliegt. Weder das Verschieben des Elements noch eine Änderung an einem xmlns-Attribut ändert diesen Wert. Vergleiche in einem Baum mit mehreren Namensräumen namespaceURI und localName (den Namen ohne Präfix). Mit document.createElementNS() wählst du bei der Erstellung den Namensraum ausdrücklich aus.

Weise innerHTML kein nicht vertrauenswürdiges Markup zu: Standardmäßig wird es nicht bereinigt und kann XSS ermöglichen, etwa über Ereignishandler-Attribute. Verwende für reinen Text textContent. Erzwingt die CSP Trusted Types, löst eine gewöhnliche Zeichenkette ohne Standardrichtlinie einen TypeError aus. Ein TrustedHTML-Wert ist nur so sicher wie die Richtlinie, die ihn erzeugt hat. Diese APIs gehören zur Webplattform, nicht zu ECMAScript 2024; setze sie in Laufzeitumgebungen ohne DOM nicht voraus.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML and SVG element names</title>
</head>
<body>
  <script>
    const container = document.createElement('div');
    const previous = document.createElement('span');
    container.appendChild(previous);

    container.innerHTML = '<a>HTML</a><svg><a>SVG</a></svg>';
    const htmlLink = container.firstElementChild;
    const svgLink = container.lastElementChild.firstElementChild;

    console.log(container.innerHTML);
    for (const link of [htmlLink, svgLink]) {
      console.log(`${link.tagName} | ${link.localName} | ${link.namespaceURI}`);
    }
    console.log(previous.parentNode === null);
  </script>
</body>
</html>

Ergebnis

<a>HTML</a><svg><a>SVG</a></svg>
A | a | http://www.w3.org/1999/xhtml
a | a | http://www.w3.org/2000/svg
true

Speichere das Beispiel als `.html`-Datei und öffne sie direkt im Browser. Die Ausgabe findest du in der Entwicklerkonsole. Beide Elemente haben `a` als `localName`, aber unterschiedliche Werte für `tagName` und `namespaceURI`. Das letzte `true` zeigt, dass der alte Kindknoten keinen Elternknoten mehr hat.

Zugehörige Lektionen

  • JavaScript · Lektion 16 · Fortgeschritten · Version: 4

Quellen