XML DOM insertNode() 方法
定義和用法
insertNode() 方法在範圍的開頭插入一個節點。
語法：
insertNode(newNode)
參數
| 參數 | Description |
|---|---|
| newNode | 要插入文檔的節點。 |
引發
如果 newNode 是 Attr、Document、Entity 或 Notation 节點，此方法將引發代碼為 INVALID_NODE_TYPE_ERR 的 RangeException 異常.
在以下條件下，此方法還會引發如下代碼的 DOMException 異常：
- HIERARCHY_REQUEST_ERR - 节點開始範圍不能有子節點，它也不能有指定類型的子節點，或者 newNode Adalah cawangan-nod ini (atau ia sendiri).
- NO_MODIFICATION_ALLOWED_ERR - Nod yang mengandungi titik awal rangkaian (atau cawangan-cawangannya) adalah hanya baca.
- WRONG_DOCUMENT_ERR - newNode Berbeza daripada dokumen yang dimiliki rangkaian.
Description
Metode ini akan memasukkan nod yang ditentukan (dan semua cawangan-cawangannya) ke titik awal rangkaian dokumen. Apabila metode ini kembali, rangkaian semasa akan termasuk nod yang baru dipasangkan. newNode Sudah menjadi sebahagian daripada dokumen, maka ia akan dipindahkan daripada lokasi semasa dan di pasangkan semula di titik awal range. Jika newNode Adalah Nod DocumentFragment, maka yang dipasang bukan adalah ia sendiri, tetapi cawangan-cawangannya, di pasangkan di urutan titik awal range.
Jika nod yang mengandungi titik awal range adalah nod Text, maka sebelum operasi pemasukan dilakukan, ia akan disahutkan kepada dua nod berdekatan. Jika newNode Adalah nod Text, selepas dimasukkan ke dokumen, ia tidak akan disatukan dengan nod Text yang berdekatan. Untuk menyatukan nod yang berdekatan, perlu memanggil Node.normalize() Metode.
