XML DOM insertNode() 메서드
정의와 사용법
insertNode() 메서드는 범위의 시작에 노드를 삽입합니다.
문법:
insertNode(newNode)
매개변수
| 매개변수 | 설명 |
|---|---|
| newNode | 문서에 삽입할 노드. |
발생시킵니다
만약 newNode Attr, Document, Entity 또는 Notation 노드라면 INVALID_NODE_TYPE_ERR 코드를 발생시키는 RangeException 예외.
다음 조건하에서 이 메서드는 다음과 같은 DOMException 예외를 발생시킵니다:
- HIERARCHY_REQUEST_ERR - 포함 범위의 시작 점의 노드는 자식 노드가 없어야 하며, 지정된 타입의 자식 노드도 없어야 합니다 또는 newNode 는 이 노드의 조상 노드(또는 이 노드 자체)입니다.
- NO_MODIFICATION_ALLOWED_ERR - 범위의 시작점을 포함하는 노드(또는 그의 조상 노드)가 읽기 전용입니다.
- WRONG_DOCUMENT_ERR - newNode 범위가 속한 문서와 다릅니다.
설명
이 메서드는 지정된 노드(그리고 그의 모든 자손 노드)를 문서 범위의 시작점에 삽입합니다. 이 메서드가 반환될 때, 현재 범위는 새로 삽입된 노드를 포함합니다. 만약 newNode 이미 문서의 일부로 되어 있으면, 그것은 현재 위치에서 제거되고 다시 범위의 시작점에 재삽입됩니다. 만약 newNode 는 DocumentFragment 노드이렇게 되면, 삽입되는 것은 그 자체가 아니라 그의 자손 노드들이 범위의 시작점에 순서대로 삽입됩니다.
현재 범위의 시작점을 포함하는 노드가 Text 점이면, 삽입 작업이 발생하기 전에 그것은 두 인접한 점으로 분할됩니다. 만약 newNode Text 점, 문서에 삽입된 후, 그것은 어떤 인접한 Text 점과도 결합되지 않습니다. 인접한 점을 결합하려면, Node.normalize() 메서드.
