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 Oktober 2020.
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
replaceChildren(param1)
replaceChildren(param1, param2)
replaceChildren(param1, param2, /* …, */ paramN)
Parameter
param1, …,paramN-
Eine Reihe von
Node-Objekten oder Zeichenketten, mit denen die vorhandenen Kinder desDocumentFragmentersetzt werden sollen. Wenn keine Ersetzungsobjekte angegeben sind, wird dasDocumentFragmentvon allen Kindknoten geleert.
Rückgabewert
Keiner (undefined).
Ausnahmen
HierarchyRequestErrorDOMException-
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:
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 # ref-for-dom-parentnode-replacechildren① |
Browser-Kompatibilität
Loading…