La méthode Range.extractContents() déplace le contenu du Range depuis l’arbre du document dans un DocumentFragment.

Les gestionnaires d’évènements ajoutés en utilisant les méthodes du DOM ne sont pas conservés lors de l’extraction. les attributs HTML d’évènements sont conservés ou dupliqués comme ils le seraient avec la méthode Node.cloneNode(). Les attributs HTML id sont également clonés, ce qui peut mener à un document invalide si un nœud partiellement sélectionné est extrait et ajouté au document.

Les nœuds partiellement sélectionnés sont clonés pour inclure les balises parentes nécessaires pour rendre le fragment de document valide.

Syntaxe

documentFragment = range.extractContents();

Exemples

var range = document.createRange();
range.selectNode(document.getElementsByTagName("div").item(0));
var documentFragment = range.extractContents();
document.body.appendChild(documentFragment);

Spécifications

Spécification Statut Commentaire
DOM
La définition de 'Range.extractContents()' dans cette spécification.
Standard évolutif Pas de changement.
Document Object Model (DOM) Level 2 Traversal and Range Specification
La définition de 'Range.extractContents()' 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
extractContentsChrome 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 : SphinxKnight,