Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez également contribuer en rejoignant la communauté francophone sur MDN Web Docs.

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