XML DOM surroundContents() 方法
定义和用法
surroundContents() 方法用指定的节点包围范围的内容。
语法：
surroundContents(newParent)
参数
| 参数 | 描述 |
|---|---|
| newParent | 将成为当前范围内容的新父节点的节点。 |
抛出
该方法将在下列情况下抛出具有如下代码的 DOMException 异常或 RangeException 异常：
DOMException.HIERARCHY_REQUEST_ERR
当前范围的开始点的包容节点不能有子节点，不能有 newParent 类型的子节点，或者 newParent 是包容节点的祖先节点。
DOMException.NO_MODIFICATION_ALLOWED_ERR
当前范围的边界点的祖先节点是只读的，不允许进行插入操作。
DOMException.WRONG_DOCUMENT_ERR
newParent 和它的范围是用不同 Document 对象创建的。
RangeException.BAD_BOUNDARYPOINTS_ERR
当前范围部分地选择了一个节点（除了 Text 节点外的），所以不能包围文档的这个区域。
RangeException.INVALID_NODE_TYPE_ERR
newParent 是 Document、DocumentFragment、DocumentType、Attr、Entity 或 Notation 节点。
描述
该方法将把当前范围的父节点重定为 newParent，然后把 newParent 插在文档中范围的开始位置。例如，把文档的一个区域放入 <div> 或 <span> 元素中，可以使用该方法。
如果 newParent 已经是文档的一部分，那么它首先将从文档中删除，它的子节点也将被舍弃。当该方法返回时，该范围将以 newParent 之前的位置为开始点，newParent 之后的位置为结束点。