XML DOM surroundContents() 方法

定义和用法

surroundContents() 方法用指定的节点包围范围的内容。

语法：

surroundContents(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 之后的位置为结束点。