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 その後の場所が終了ポイントです。
