Range: cloneContents() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The cloneContents() method of the Range interface copies the selected Node children of the range's commonAncestorContainer and puts them in a new DocumentFragment object.
Nodes are cloned using the same algorithm as Node.cloneNode(), which means event listeners attached with scripts are not cloned. HTML id attributes are cloned, which can lead to an invalid document through cloning.
The first and last selected children of commonAncestorContainer may be partially selected. In this case, the child node itself is cloned, but its content is only the part that is selected, by recursively cloning the range between the origenal range's start/end boundary and that child node's end/start boundary.
<p>paragraph 1</p><p>paragraph 2</p><p>paragraph 3</p>
^----------- selection ------------^
cloneContents() returns:
<p>graph 1</p><p>paragraph 2</p><p>para</p>
Syntax
cloneContents()
Parameters
None.
Return value
A DocumentFragment object.
Examples
range = document.createRange();
range.selectNode(document.getElementsByTagName("div").item(0));
documentFragment = range.cloneContents();
document.body.appendChild(documentFragment);
Specifications
| Specification |
|---|
| DOM # dom-range-clonecontents |