مетод insertNode() XML DOM

Range آوٹھا مرجع دستاویز

تعریف و استفاده

مетод 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 نقصان، تو اس میں شروع کی پوائنٹ کا پتھر نہیں آیا، بلکہ اس کا پتھر کا پتھر آیا، پتھر کی شروع کی پوائنٹ کا پتھر کی ترتیب سے شروع کی پوائنٹ میں شامل کیا جائے گا۔

اگر شروع کی پوائنٹ کا نقصان کسی Text نقصان میں ہے تو، اس کا پتھر پیش کی جب اس میں شروع کی پوائنٹ کا پتھر پیش کیا جائے گا، تو اس کا پتھر دو قریبی نقصان میں تقسیم کیا جائے گا۔ اگر newNode یہ Text نقصان ہے، اس کی تعمیر کے بعد، یہ کسی قریبی Text نقصان کے ساتھ جوڑ نہیں جائے گا۔ قریبی نقصان کو جوڑنا چاہئے تو، Node.normalize() مہارت

دیکھئے

DocumentFragment آوٹھا، Node.normalize()。

Range آوٹھا مرجع دستاویز