Phương thức surroundContents() của XML DOM
Định nghĩa và cách sử dụng
Phương thức surroundContents() sử dụng nút chỉ định bao quanh nội dung phạm vi.
Ngữ pháp:
surroundContents(newParent)
Tham số
| Tham số | Mô tả |
|---|---|
| newParent | Sẽ trở thành nút cha mới của nội dung phạm vi hiện tại. |
Ném ra
Phương thức này sẽ ném ra lỗi có mã sau trong các trường hợp sau: Lỗi DOMExceptionhoặc Lỗi RangeException:
DOMException.HIERARCHY_REQUEST_ERR
nút bao gồm điểm bắt đầu của phạm vi hiện tại không thể có nút con, không thể có newParent con nút con của loại, hoặc newParent Là nút bậc cao của nút bao gồm.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Nút tổ tiên của điểm giới hạn phạm vi hiện tại là chỉ đọc, không được phép thực hiện thao tác chèn.
DOMException.WRONG_DOCUMENT_ERR
newParent và phạm vi của nó được tạo bằng đối tượng Document khác.
RangeException.BAD_BOUNDARYPOINTS_ERR
Phạm vi hiện tại chọn phần nào của nút (ngoại trừ nút Text), vì vậy không thể bao quanh khu vực này của tài liệu.
RangeException.INVALID_NODE_TYPE_ERR
newParent Là nút Document, DocumentFragment, DocumentType, Attr, Entity hoặc Notation.
Mô tả
Phương pháp này sẽ đặt lại nút cha hiện tại của phạm vi hiện tại là newParent, sau đó đặt newParent Chèn vào vị trí bắt đầu của phạm vi tài liệu. Ví dụ, để đặt một khu vực của tài liệu vào phần tử <div> hoặc <span>, bạn có thể sử dụng phương pháp này.
Nếu newParent Nếu nó đã là một phần của tài liệu, nó sẽ được xóa khỏi tài liệu trước, và các nút con của nó cũng sẽ bị loại bỏ. Khi phương pháp này trả về, phạm vi sẽ có newParent Vị trí trước là điểm bắt đầu,newParent Vị trí sau là điểm kết thúc.
