Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Range.createContextualFragment()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthodeRange.createContextualFragment() retourne unDocumentFragment en invoquant l'algorithme d'analyse de fragment HTML ou l'algorithme d'analyse de fragment XML, avec le début durange (leparent du nœud sélectionné) comme nœud de contexte. L'algorithme d'analyse de fragment HTML est utilisé si lerange appartient à unDocument dont le bit « HTMLness » est défini. Dans le cas du HTML, si le nœud de contexte est censé êtrehtml, pour des raisons historiques l'algorithme d'analyse de fragment est invoqué avecbody pour contexte à la place.
Dans cet article
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 contexterange.selectNode(document.getElementsByTagName("div").item(0));var documentFragment = range.createContextualFragment(chaineHTML);document.body.appendChild(documentFragment);Spécifications
| Specification |
|---|
| HTML> # dom-range-createcontextualfragment> |