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