XML DOM surroundContents() 方法

定义和用法

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

语法:

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