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 之后的位置為結束點。
