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
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écifications
| Specification |
|---|
| HTML Standard # dom-range-createcontextualfragment |
Compatibilité des navigateurs
BCD tables only load in the browser