Range.surroundContents()

La méthode Range.surroundContents() déplace le contenu du Range dans un nouveau nœud, plaçant le nouveau nœud au début du range spécifié.

Cette méthode est à peu près équivalente à :

newNode.appendChild(range.extractContents());
range.insertNode(newNode)

Après déplacement, les bornes du range incluent newNode.

Cependant, une exception sera levée si le Range découpe un nœud non-Text sur une seule de ses bornes. C’est-à-dire que, contrairement à l’alternative ci-dessus, s’il y a des nœuds partiellement sélectionnés, ils ne seront pas clonés ; à la place, l’opération échouera.

Syntaxe

range.surroundContents(newNode);

Paramètres

newNode
Un Node à insérer à l’emplacement du range.

Exemple

var range = document.createRange();
var newNode = document.createElement("p");

range.selectNode(document.getElementsByTagName("div").item(0));
range.surroundContents(newNode);

Spécifications

Spécification Statut Commentaire
DOM
La définition de 'Range.surroundContents()' dans cette spécification.
Standard évolutif Pas de changement.
Document Object Model (DOM) Level 2 Traversal and Range Specification
La définition de 'Range.surroundContents()' dans cette spécification.
Obsolete Spécification initiale.

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi