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
replaceChildren(param1)
replaceChildren(param1, param2)
replaceChildren(param1, param2, /* …, */ paramN)
Parameter
param1
, …,paramN
-
Eine Reihe von
Node
-Objekten oder Zeichenketten, mit denen die vorhandenen Kinder desDocumentFragment
ersetzt werden sollen. Wenn keine Ersetzungsobjekte angegeben sind, wird dasDocumentFragment
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:
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