Range: surroundContents() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
Die Range.surroundContents()
Methode verschiebt den Inhalt des
Range
in einen neuen Knoten und platziert den neuen Knoten am Anfang des
angegebenen Bereichs.
Diese Methode ist nahezu gleichwertig zu
newNode.appendChild(range.extractContents()); range.insertNode(newNode)
.
Nach dem Umgeben beinhalten die Randpunkte des range
newNode
.
Eine Ausnahme wird jedoch ausgelöst, wenn der Range
einen nicht-Text
Knoten mit nur einem seiner Randpunkte teilt. Das bedeutet, im Gegensatz zu der
oben genannten Alternative, dass teilweise ausgewählte Knoten nicht geklont werden und
stattdessen die Operation fehlschlägt.
Syntax
surroundContents(newParent)
Parameter
Rückgabewert
Keiner (undefined
).
Beispiele
HTML
<span class="header-text">Put this in a headline</span>
JavaScript
const range = document.createRange();
const newParent = document.createElement("h1");
range.selectNode(document.querySelector(".header-text"));
range.surroundContents(newParent);
Ergebnis
Spezifikationen
Specification |
---|
DOM Standard # dom-range-surroundcontents |
Browser-Kompatibilität
BCD tables only load in the browser