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
BCD tables only load in the browser
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter https://github.com/mdn/browser-compat-data et à nous envoyer une pull request.