CharacterData: replaceWith()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.
Die replaceWith()-Methode des CharacterData-Interfaces ersetzt diesen Knoten in der Kinderliste seines Elternteils mit einer Gruppe von Node-Objekten oder Zeichenfolgen.
Zeichenfolgen werden als Text-Knoten eingefügt; die Zeichenfolge wird als Argument an den Text()-Konstruktor übergeben.
Syntax
replaceWith(...nodes)
Parameter
nodesOptional-
Eine durch Kommas getrennte Liste von
Node-Objekten oder Zeichenfolgen, die den aktuellen Knoten ersetzen werden.
Hinweis: Wenn keine Argumente übergeben werden, entfernt diese Methode den Knoten aus dem DOM-Baum.
Rückgabewert
Keiner (undefined).
Ausnahmen
HierarchyRequestErrorDOMException-
Wird ausgelöst, wenn der Knoten an der angegebenen Stelle in der Hierarchie nicht eingefügt werden kann.
Beispiele
<p id="myText">Some text</p>
let text = document.getElementById("myText").firstChild;
let em = document.createElement("em");
em.textContent = "Italic text";
text.replaceWith(em); // Replace `Some text` by `Italic text`
Spezifikationen
| Spezifikation |
|---|
| DOM # ref-for-dom-childnode-replacewith① |