Metode XML DOM surroundContents()
Definisi dan penggunaan
Metode surroundContents() digunakan untuk mengelilingi kandungan rentang dengan node yang ditentukan.
Syarat:
surroundContents(newParent)
Parameter
| Parameter | Deskripsi |
|---|---|
| newParent | Became the new parent node of the content of the current range. |
Melemparkan
Metode ini akan melemparkan kesalahan dengan kode berikut dalam keadaan-keadaan berikut: Laporan kesalahan DOMExceptionatau Laporan kesalahan RangeException:
DOMException.HIERARCHY_REQUEST_ERR
Node yang termasuk titik awal rentang kini tidak boleh mempunyai anak, tidak boleh mempunyai newParent node anak jenis, atau newParent Adalah bapa yang mempunyai node yang termasuk.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Nod bapa titik sempadan rentang semasa adalah hanya baca, dan operasi masukan tidak diizinkan.
DOMException.WRONG_DOCUMENT_ERR
newParent dan rentangnya adalah dicipta dengan Document yang berbeza.
RangeException.BAD_BOUNDARYPOINTS_ERR
Range semasa memilih sebahagian daripada nod (kecuali nod Text), jadi tidak dapat melingkungi kawasan ini di dokumen ini.
RangeException.INVALID_NODE_TYPE_ERR
newParent Adalah nod Dokument, DocumentFragment, DocumentType, Attr, Entity atau Notation.
Deskripsi
Kaedah ini akan mengubah parent rentang semasa kepada newParent, lalu newParent Disisipkan di tempat awal rentang dokumen. Contohnya, memasukkan kawasan dokumen ke dalam elemen <div> atau <span>, boleh digunakan kaedah ini.
Jika newParent Sudah menjadi sebahagian daripada dokumen, jadi ia akan dipindahkan daripada dokumen dahulu, dan anak-nya juga akan diabaikan. Apabila kaedah ini kembali, rentang ini akan dihapuskan dengan newParent Lokasi sebelumnya adalah titik awal,newParent Lokasi seterusnya adalah titik akhir.
