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 surroundContents() Methode des Range-Interfaces umgibt den ausgewählten Inhalt mit einem bereitgestellten Knoten. Sie extrahiert den Inhalt des Bereichs, ersetzt die Kinder von newParent mit dem extrahierten Inhalt, fügt newParent an der Stelle des extrahierten Inhalts ein und lässt den Bereich newParent auswählen.
Eine Ausnahme wird ausgelöst, wenn der Bereich teilweise einen Nicht-Text-Knoten enthält. Der Bereich darf nur Textknoten und vollständig ausgewählte Knoten enthalten.
Syntax
js
surroundContents(newParent)
Parameter
Rückgabewert
Keiner (undefined).
Beispiele
HTML
html
<span class="header-text">Put this in a headline</span>
JavaScript
js
const range = document.createRange();
const newParent = document.createElement("h1");
range.selectNode(document.querySelector(".header-text"));
range.surroundContents(newParent);
Ergebnis
Spezifikationen
| Specification |
|---|
| DOM # dom-range-surroundcontents |