Phương pháp insertNode() của XML DOM
Định nghĩa và cách sử dụng
Phương pháp insertNode() chèn một nút vào đầu của phạm vi.
Cú pháp:
insertNode(newNode)
Tham số
| Tham số | Mô tả |
|---|---|
| newNode | Để chèn nút vào tài liệu. |
Ném
Nếu newNode Là nút Attr, Document, Entity hoặc Notation, phương pháp này sẽ ném mã INVALID_NODE_TYPE_ERR Ngoại lệ RangeException.
Trong các điều kiện sau, phương pháp này cũng sẽ ném ngoại lệ DOMException với mã sau:
- LỖI_YÊU_CAU_HIERARCHY - Điểm bắt đầu của phạm vi không thể có các nút con, nó cũng không thể có các nút con của loại đã chỉ định hoặc newNode Là tổ tiên của nút này (hoặc là chính nó).
- NO_MODIFICATION_ALLOWED_ERR - Nút chứa điểm bắt đầu của phạm vi (hoặc là tổ tiên của nó) là chỉ đọc.
- WRONG_DOCUMENT_ERR - newNode khác với tài liệu mà phạm vi thuộc về.
Mô tả
Phương pháp này sẽ chèn các nút chỉ định (và tất cả các con của nó) vào điểm bắt đầu của phạm vi tài liệu. Khi phương pháp này trả về, phạm vi hiện tại sẽ bao gồm các nút được chèn mới. Nếu newNode Đã là một phần của tài liệu, nó sẽ bị xóa từ vị trí hiện tại và được chèn lại từ điểm bắt đầu của phạm vi. Nếu newNode Là Nút DocumentFragmentthì không phải là nó selbst được chèn, mà là các con của nó, được chèn theo thứ tự điểm bắt đầu của phạm vi.
Nếu nút chứa điểm bắt đầu của phạm vi hiện tại là nút Text, thì trước khi thực hiện thao tác chèn, nó sẽ được chia thành hai nút Text cạnh nhau. Nếu newNode Là nút Text, sau khi chèn vào tài liệu, nó sẽ không hợp nhất với bất kỳ nút Text nào bên cạnh. Để hợp nhất các nút bên cạnh, cần gọi Node.normalize() phương pháp.
