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 ⁨Juli 2015⁩.

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