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

js
surroundContents(newParent)

Parameter

newParent

Ein Node, mit dem der Inhalt umgeben wird.

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch