Range.createContextualFragment()

La méthode Range.createContextualFragment() retourne un DocumentFragment en invoquant l’algorithme d’analyse de fragment HTML ou l’algorithme d’analyse de fragment XML, avec le début du range (le parent du nœud sélectionné) comme nœud de contexte. L’algorithme d’analyse de fragment HTML est utilisé si le range appartient à un Document dont le bit « HTMLness » est défini. Dans le cas du HTML, si le nœud de contexte est censé être html, pour des raisons historiques l’algorithme d’analyse de fragment est invoqué avec body pour contexte à la place.

Syntaxe

documentFragment = range.createContextualFragment( chaineHTML )

Paramètres

chaineHTML
Une chaîne contenant du texte et des balises à convertir en un fragment de document.

Exemple

var chaineHTML = "<div>Je suis un nœud div<div>";
var range = document.createRange();
// fait que le parent de la première div du document devient le nœud de contexte
range.selectNode(document.getElementsByTagName("div").item(0));
var documentFragment = range.createContextualFragment(chaineHTML);
document.body.appendChild(documentFragment);

Spécification

Spécification Statut Commentaire
DOM Parsing and Serialization
La définition de 'Range.createContextualFragment()' dans cette spécification.
Version de travail Définition initiale.

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi