定義和用法

surroundContents() 方法用指定的節(jié)點包圍范圍的內(nèi)容。

語法：

surroundContents(newParent)

參數(shù)

參數(shù)	描述
newParent	將成為當前范圍內(nèi)容的新父節(jié)點的節(jié)點。

拋出

該方法將在下列情況下拋出具有如下代碼的 DOMException 異常或 RangeException 異常：

DOMException.HIERARCHY_REQUEST_ERR

當前范圍的開始點的包容節(jié)點不能有子節(jié)點，不能有 newParent 類型的子節(jié)點，或者 newParent 是包容節(jié)點的祖先節(jié)點。

DOMException.NO_MODIFICATION_ALLOWED_ERR

當前范圍的邊界點的祖先節(jié)點是只讀的，不允許進行插入操作。

DOMException.WRONG_DOCUMENT_ERR

newParent 和它的范圍是用不同 Document 對象創(chuàng)建的。

RangeException.BAD_BOUNDARYPOINTS_ERR

當前范圍部分地選擇了一個節(jié)點（除了 Text 節(jié)點外的），所以不能包圍文檔的這個區(qū)域。

RangeException.INVALID_NODE_TYPE_ERR

newParent 是 Document、DocumentFragment、DocumentType、Attr、Entity 或 Notation 節(jié)點。

描述

該方法將把當前范圍的父節(jié)點重定為 newParent，然后把 newParent 插在文檔中范圍的開始位置。例如，把文檔的一個區(qū)域放入 <div> 或 <span> 元素中，可以使用該方法。

如果 newParent 已經(jīng)是文檔的一部分，那么它首先將從文檔中刪除，它的子節(jié)點也將被舍棄。當該方法返回時，該范圍將以 newParent 之前的位置為開始點，newParent 之后的位置為結(jié)束點。