XML DOM insertNode() 方法
定义和用法
insertNode() 方法在范围的开头插入一个节点。
语法：
insertNode(newNode)
参数
| 参数 | وصف |
|---|---|
| newNode | 要插入文档的节点。 |
抛出
如果 newNode 是 Attr、Document、Entity 或 Notation 节点，该方法将抛出代码为 INVALID_NODE_TYPE_ERR 的 RangeException 异常.
在以下条件下，该方法还将抛出以下代码的 DOMException 异常：
- HIERARCHY_REQUEST_ERR - 谷物请求错误 - 包含范围的开始点的节点不能有子节点，它也不能有指定类型的子节点，或者 newNode هي نود الأب لهذا النود (أو هو النود نفسه).
- NO_MODIFICATION_ALLOWED_ERR - النود الذي يحتوي على نقطة البداية الحالية للنطاق (أو نود الأب لذلك النود) هو غير قابل للتغيير.
- WRONG_DOCUMENT_ERR - newNode مختلف عن وثيقة النطاق.
وصف
ستقوم هذه الطريقة بإدراج النود المحدد (وكل نود أبناءه) في نقطة البداية الحالية للنطاق. عند إكمال هذه الطريقة، سيشمل النطاق الحالي النود الجديد المدرج. إذا newNode إذا كان جزء من وثيقة الموقع، فإنه سيتم إزالته من الموضع الحالي وإعادة إدراجه في نقطة البداية الحالية للنطاق. إذا newNode هي نود DocumentFragment، فإن النود الذي يتم إدراجه ليس هو نفسه، بل هو نود أبناءه، ويتم إدراج نقطة البداية الحالية للنطاق بالترتيب.
إذا كان النود الذي يحتوي على نقطة البداية الحالية هو نود نصي، فإنه سيتم تقسيمه إلى نود نصي مجاورين قبل تنفيذ عملية الإدراج. إذا newNode هذا هو نود نصي، بعد إدراجه في الوثيقة، لن يدمج مع أي نود نصي مجاور. لإلزام النود المجاورة، من الضروري تنفيذ Node.normalize() طريقة.
