طريقة insertNode() في XML DOM
التعريف والاستخدام
يضيف الطريقة insertNode() نودًا واحدًا في بداية النطاق.
النحو:
insertNode(newNode)
المعدل
المعدل | الوصف |
---|---|
newNode | النود الذي سيتم إدراجه في المستند. |
إطلاق
إذا newNode إذا كانت النوع هي Attr،Document،Entity أو Notation،فسيتم إطلاق استثنائية INVALID_NODE_TYPE_ERR استثنائية RangeException.
في الحالات التالية، سيزيد هذا الطريقة من استثنائية DOMException كما يلي:
- خطأ طلب الهيكلية - لا يمكن أن يكون لديرزن البداية للنطاق أي فرع، ولا يمكن أن يكون لديه فرع من نوع معين، أو newNode هو نود الأصل (أو هو نفس النود).
- NO_MODIFICATION_ALLOWED_ERR - النود الذي يحتوي على نقطة البداية الحالية للنطاق (أو أحد أجداده) هو غير قابل للتغيير.
- WRONG_DOCUMENT_ERR - newNode مختلف عن المستند الذي ينتمي إليه النطاق.
الوصف
ستقوم هذه الطريقة بإدراج النود المحدد (وكل أبناءه) في نقطة البداية الحالية لنطاق المستند. عند إكمال هذه الطريقة، سيشمل النطاق الحالي النود المدرج الجديد. إذا newNode إذا كان بالفعل جزءًا من المستند، فإنه سيتم حذفه من الموضع الحالي وإعادة إدراجه في نقطة البداية الحالية للنطاق. إذا newNode هو نود DocumentFragment، فإنما يتم إدراج غيره وليس نفسه، بل أبناءه، وإدراج نقطة البداية الحالية للحالة.
إذا كان النود الذي يحتوي على نقطة البداية الحالية هو نود Text، فإنه سيتم تقسيمه إلى نود مجاورة قبل إجراء عملية الإدراج. إذا newNode هو نود Text، بعد إدراجه في المستند، لن يندمج مع أي نود Text مجاورة. لدمج النود المجاورة، يجب عليك تفعيل Node.normalize() الطريقة.