JavaScript/DOM/ParentNode/replaceChildren

Aus SELFHTML-Wiki
Wechseln zu: Navigation, Suche

Die Methode ParentNode.replaceChildren() entfernt sämtliche Kind-Knoten eines Elements, Dokuments oder Dokumentfragments und setzt statt dessen die übergebene Liste von Knoten oder Strings als neue Kindelemente ein. Strings werden dabei als Text-Knoten eingefügt.

Die Evergreen-Browser haben die Methode im Jahr 2020 implementiert.

Syntax

element = parentNode.replaceChildren((Node oder DOMString)... nodes);

  • parentNode: Element, Dokument oder Dokumentfragment, worin die übergebenen Nodes eingefügt werden sollen.
  • ...nodes: beliebig viele Knoten (Node oder Strings), die als Kind-Knoten des Elements zulässig sind. Die "..." Notation ist dabei als Rest-Operator zu verstehen.

Die Methode gibt undefined zurück. Sie kann einen HierarchyRequestError werfen, wenn die Regeln zur Konstruktion des DOM Baumes verletzt werden.

Siehe auch

Weblinks