XML DOM روش insertNode()
تعریف و استفاده
مетод 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() روش.
