DocumentFragment: replaceChildren()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die DocumentFragment.replaceChildren()-Methode ersetzt die vorhandenen Kinder eines DocumentFragment durch einen festgelegten neuen Satz von Kindern. Diese können Zeichenketten oder Node-Objekte sein.

Syntax

js
replaceChildren(param1)
replaceChildren(param1, param2)
replaceChildren(param1, param2, /* …, */ paramN)

Parameter

param1, …, paramN

Eine Reihe von Node-Objekten oder Zeichenketten, mit denen die vorhandenen Kinder des DocumentFragment ersetzt werden sollen. Wenn keine Ersetzungsobjekte angegeben sind, wird das DocumentFragment von allen Kindknoten geleert.

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException

Wird ausgelöst, wenn die Einschränkungen des Knotensbaums verletzt werden.

Beispiele

Ein Dokument-Fragment leeren

replaceChildren() bietet eine sehr praktische Möglichkeit, ein Dokument-Fragment von all seinen Kindern zu leeren. Sie rufen es für das Dokument-Fragment ohne Angabe von Argumenten auf:

js
let fragment = new DocumentFragment();
let div = document.createElement("div");
let p = document.createElement("p");
fragment.append(p);
fragment.prepend(div);

fragment.children; // HTMLCollection [<div>, <p>]

fragment.replaceChildren();

fragment.children; // HTMLCollection []

Spezifikationen

Specification
DOM Standard
# ref-for-dom-parentnode-replacechildren①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch