Range.extractContents()

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

js
documentFragment = range.extractContents();

Exemples

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

Spécifications

Specification
DOM Standard
# dom-range-extractcontents

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi