Range.createContextualFragment()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

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
HTML
# dom-range-createcontextualfragment

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
createContextualFragment

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi