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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
surroundContentsChrome Support complet OuiEdge Support complet 12Firefox Support complet 4IE Support complet 9Opera Support complet 9Safari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android ?

Légende

Support complet  
Support complet
Compatibilité inconnue  
Compatibilité inconnue

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : mdnwebdocs-bot, Watilin
Dernière mise à jour par : mdnwebdocs-bot,