Range: surroundContents() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

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

surroundContents(newParent)

Parameter

newParent: Ein Node, mit dem der Inhalt umgeben wird.

<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);