WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ShadowRoot.append — Knoten und Text an einen Shadow Tree anhängen

ShadowRoot.append hängt Knoten und Text am Ende eines Shadow Trees an. Die Methode wird von DocumentFragment geerbt und ist keine separate Implementierung. Erfahre, wie Knoten verschoben werden, ein Fragment geleert wird und worin sich appendChild() unterscheidet.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

shadowRoot.append(...nodesOrStrings);
fragment.append(...nodesOrStrings);

ShadowRoot.append ist die geerbte Methode DocumentFragment.append: ShadowRoot erbt von DocumentFragment. Ein Aufruf von root.append(...) fügt Inhalt nach dem letzten Kind des Shadow Roots ein, nicht zu den gewöhnlichen Kindern des Host-Elements. Ein gewöhnliches Fragment dient dagegen dazu, einen Teilbaum zusammenzustellen, bevor er an seinem Ziel eingefügt wird.

Die Methode akzeptiert mehrere Knoten und Zeichenfolgen in der Reihenfolge der Argumente. Zeichenfolgen werden zu Text-Knoten; sie werden nicht als HTML geparst. Ein vorhandener Knoten wird verschoben, nicht kopiert. Wird ein gewöhnliches DocumentFragment übergeben, werden seine Kinder verschoben und das Fragment bleibt leer; das Fragment selbst wird kein Kind des Roots.

Das Ergebnis ist undefined. Im Gegensatz zu append() akzeptiert appendChild() einen einzelnen Knoten, unterstützt Zeichenfolgen nicht direkt als Argumente und gibt den hinzugefügten Knoten oder das geleerte Fragment zurück. Eine ungültige Einfügung, etwa eine, die einen Zyklus erzeugt, kann eine HierarchyRequestError-DOMException auslösen.

Dies ist eine DOM-API und keine Funktion einer bestimmten ECMAScript-Ausgabe. MDN kennzeichnet DocumentFragment.append() seit April 2018 als browserübergreifend breit verfügbar; die Verwendung an einem Shadow Root erfordert zusätzlich Shadow-DOM-Unterstützung. Dass Node 24 in einem Repository vorhanden ist, belegt allein keine Unterstützung dieser Browser-APIs.

Beispiele

(() => {
  const host = document.createElement("div");
  const root = host.attachShadow({ mode: "open" });
  const fragment = document.createDocumentFragment();
  const label = document.createElement("strong");
  label.textContent = "DOM";

  fragment.append("Hello ", label);
  const result = root.append(fragment, "!");

  console.log(root.textContent);
  console.log(root.childNodes.length);
  console.log(fragment.childNodes.length);
  console.log(label.parentNode === root);
  console.log(host.childNodes.length);
  console.log(result === undefined);
})();

Ergebnis

Hello DOM!
3
0
true
0
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen