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

js
documentFragment = range.createContextualFragment(chaineHTML);

Paramètres

chaineHTML

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

Exemple

js
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écifications

Specification
DOM Parsing and Serialization
# ref-for-dom-range-createcontextualfragment-2

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi