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 이후 위치가 종료점입니다.
