XML DOM روش surroundContents()
تعریف و استفاده
روش surroundContents() محتوای محدوده را با نودهای مشخص شده دربر می‌گیرد.
نحوه استفاده:
surroundContents(newParent)
پارامتر
| پارامتر | شرح |
|---|---|
| newParent | این نود خواهد شد که به عنوان والد جدید محتوای محدوده فعلی خواهد بود. |
پرتاب می‌کند
این روش در موارد زیر خطای کد زیر را پرتاب می‌کند DOMException خطایا RangeException خطا：
DOMException.HIERARCHY_REQUEST_ERR
نقطه دربرگیرنده شروع محدوده فعلی نمی‌تواند نودهای فرزند داشته باشد، نمی‌تواند داشته باشد newParent نods فرزند نوعی، یا newParent این نقطه والد یک نقطه دربرگیرنده است.
DOMException.NO_MODIFICATION_ALLOWED_ERR
گره‌های اجدادی محدوده فعلی خوانا هستند و عملیات اضافه کردن مجاز نیست.
DOMException.WRONG_DOCUMENT_ERR
newParent و محدوده آن با Document متفاوت است.
RangeException.BAD_BOUNDARYPOINTS_ERR
بخشی از محدوده فعلی یک گره را انتخاب کرده است (به استثنای گره Text)، بنابراین نمی‌توان این بخش از مستند را احاطه کرد.
RangeException.INVALID_NODE_TYPE_ERR
newParent Document، DocumentFragment، DocumentType، Attr، Entity یا Nodation هئیت هستند.
شرح
این روش پدر فعلی محدوده را به newParent، سپس newParent در مکان شروع محدوده مستند قرار می‌گیرد. به عنوان مثال، برای قرار دادن یک بخش از مستند در داخل عناصر <div> یا <span> می‌توان از این روش استفاده کرد.
اگر newParent اگر این بخش از مستند بخشی از مستند است، ابتدا از مستند حذف خواهد شد و فرزندان آن نیز حذف خواهند شد. هنگامی که این روش بازمی‌گردد، محدوده با newParent مکان قبلی به عنوان نقطه شروع است،newParent پس از این مکان به عنوان نقطه پایان است.
