surroundContents
(method
)
Owning interface and usage:
Range.
surroundContents(
newParent)
Member of these other interfaces :
none
Description:
Reparents the contents of the Range to the given node and inserts the node at the position of the start of the Range.
Parameters:
Node newParent |
- |
The node to surround the contents with.
|
Returns:
nothing
Exceptions:
- DOMException NO_MODIFICATION_ALLOWED_ERR
-
Raised if an ancestor container of either boundary-point of the Range is read-only.
- DOMException WRONG_DOCUMENT_ERR
-
Raised if newParent and the container of the start of the Range were not created from the same document.
- DOMException HIERARCHY_REQUEST_ERR
-
Raised if the container of the start of the Range is of a type that does not allow children of the type of newParent or if newParent is an ancestor of the container or if node would end up with a child node of a type not allowed by the type of node.
- DOMException INVALID_STATE_ERR
-
Raised if detach() has already been invoked on this object.
- RangeException BAD_BOUNDARYPOINTS_ERR
-
Raised if the Range partially selects a non-text node.
- RangeException INVALID_NODE_TYPE_ERR
-
Raised if node is an Attr, Entity, DocumentType, Notation, Document, or DocumentFragment node.
_____________________________________________