Range: createContextualFragment() Methode
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.
Die Range.createContextualFragment()
Methode gibt ein
DocumentFragment
zurück, indem der HTML-Fragment-Parsing-Algorithmus oder der
XML-Fragment-Parsing-Algorithmus mit dem Anfang des Ranges (dem Elternteil des
ausgewählten Knotens) als Kontextknoten aufgerufen wird. Der HTML-Fragment-Parsing-Algorithmus wird verwendet, wenn der
Bereich zu einem Document
gehört, dessen HTMLness-Bit gesetzt ist. Im HTML-Fall, wenn
der Kontextknoten html
wäre, wird aus historischen Gründen der Fragment-Parsing-Algorithmus mit body
als Kontext stattdessen aufgerufen.
Syntax
createContextualFragment(tagString)
Parameter
-
Text, der Text und Tags enthält, die in ein Dokumentfragment umgewandelt werden sollen.
Rückgabewert
Ein DocumentFragment
Objekt.
Beispiele
const tagString = "<div>I am a div node</div>";
const range = document.createRange();
// Make the parent of the first div in the document become the context node
range.selectNode(document.getElementsByTagName("div").item(0));
const documentFragment = range.createContextualFragment(tagString);
document.body.appendChild(documentFragment);
Spezifikationen
Specification |
---|
HTML Standard # dom-range-createcontextualfragment |
Browser-Kompatibilität
BCD tables only load in the browser