طريقة surroundContents() في XML DOM
التعريف والاستخدام
يستخدم طريقة surroundContents() العنصر المحدد لتشغيل محتوى المسافة.
النحو:
surroundContents(newParent)
المعدلات
| المعدلات | الوصف |
|---|---|
| newParent | سيكون العنصر الجديد الذي سيكون أباً للمحتوى الحالي للمسافة. |
استثنائية
سيتم إطلاق هذه الطريقة في الحالات التالية برمز كود استثنائية DOMExceptionأو استثنائية RangeException:
DOMException.HIERARCHY_REQUEST_ERR
العنصر الذي يمثل البداية الحالية للمسافة لا يمكن أن يكون له فرع، ولا يمكن أن يكون newParent الفرع، أو newParent هو العنصر الأب لجذر العقدة.
DOMException.NO_MODIFICATION_ALLOWED_ERR
أن أجداد نقاط الحدود الحالية للنطاق هي فقط قراءة، ولا يُسمح بإجراء عمليات إدراج.
DOMException.WRONG_DOCUMENT_ERR
newParent و النطاق هو من Document مختلف.
RangeException.BAD_BOUNDARYPOINTS_ERR
اختيار جزء من النطاق الحالي لـ Node (باستثناء نود Text)، لذا لا يمكن طويق هذه المنطقة من المستند.
RangeException.INVALID_NODE_TYPE_ERR
newParent هو نود Document، DocumentFragment، DocumentType، Attr، Entity أو Nodation.
الوصف
ستقوم هذه الطريقة بتغيير العنصر الأب الحالي للنطاق الحالي إلى newParent، ثم newParent يمكن استخدام هذه الطريقة لوضع جزء من المستند في بداية نطاق المستند. على سبيل المثال، يمكن استخدام هذه الطريقة لوضع منطقة من المستند داخل عناصر <div> أو <span>.
إذا newParent إذا كان جزءًا من مستند، فإنه سيتم إزالته أولاً من المستند، وسيتم التخلص من جميع أبنائه أيضًا. عند عودة هذه الطريقة، سيكون النطاق في newParent الموقع السابق هو نقطة البداية،newParent الموقع التالي هو نقطة النهاية.
