Method surroundContents() DOM XML
Definisi dan Penggunaan
Method surroundContents() digunakan untuk mengelilingi konten range dengan node yang ditentukan.
Syarat:
surroundContents(newParent)
parameter
| parameter | Deskripsi |
|---|---|
| newParent | node yang akan menjadi induk baru konten range saat ini. |
melempar
Method ini akan melempar eksepsi dengan kode berikut di beberapa situasi: DOMException eksepsiatau RangeException eksepsi:
DOMException.HIERARCHY_REQUEST_ERR
node penyanggul dari titik awal range saat ini tidak boleh memiliki anak, tidak boleh ada newParent node anak dari tipe, atau newParent Adalah node penyanggul dari node yang termasuk.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Anak node titik batas rentang saat ini adalah hanya-baca, tidak diijinkan operasi penambahan.
DOMException.WRONG_DOCUMENT_ERR
newParent dan rentangnya adalah yang dibuat dengan Document objek yang berbeda.
RangeException.BAD_BOUNDARYPOINTS_ERR
Rentang saat ini memilih sebagian dari node (kecuali node Text), jadi tidak dapat melingkungi area ini dari dokumen.
RangeException.INVALID_NODE_TYPE_ERR
newParent Adalah node Document, DocumentFragment, DocumentType, Attr, Entity, atau Notation.
Deskripsi
Metode ini akan mengatur ulang node orangtua saat ini ke newParent, kemudian newParent Dimasukkan di posisi awal rentang dokumen. Contohnya, untuk memasukkan area dokumen ke dalam elemen <div> atau <span>, dapat digunakan metode ini.
Jika newParent Sudah menjadi bagian dari dokumen, maka ia akan dihapus pertama dari dokumen, dan anaknya juga akan diabaikan. Saat metode ini kembali, rentang ini akan berada di newParent Lokasi sebelum ini adalah titik awal,newParent Lokasi setelah ini adalah titik akhir.
