定義和用法

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

語法：

surroundContents(newParent)

參數(shù)

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

拋出

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

DOMException.HIERARCHY_REQUEST_ERR

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

DOMException.NO_MODIFICATION_ALLOWED_ERR

當(dāng)前范圍的邊界點(diǎn)的祖先節(jié)點(diǎn)是只讀的，不允許進(jìn)行插入操作。

DOMException.WRONG_DOCUMENT_ERR

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

RangeException.BAD_BOUNDARYPOINTS_ERR

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

RangeException.INVALID_NODE_TYPE_ERR

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

描述

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

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