XML DOM surroundContents() مہم

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

تعریف اور استعمال

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

当前范围部分地选择了一个节点（除了 Text 节点外的），所以不能包围文档的这个区域。

RangeException.INVALID_NODE_TYPE_ERR

newParent 是 Document、DocumentFragment、DocumentType、Attr、Entity 或 Notation 节点。

描述

该方法将把当前范围的父节点重定为 newParent، اور بعد میں، newParent دستاویز میں کسی دائرے کی شروع کی جگہ میں چمپا دیا جائے گا، مثلاً دستاویز کا کسی علاقے کو <div> یا <span> عناصر میں رکھنا، اس میں استعمال کی جاسکتی ہے۔

اگر، newParent اگر یہ مستند کا ایک حصہ ہے تو، وہ ابتدا میں مستند سے ہٹا دیا جائے گا، اس کے ذریعہ کا بھی مستند سے ہٹا دیا جائے گا۔ جب اس طریق سے واپس آنے کا وقت آئے گا تو، اس دائرے کا شروع اور خاتمہ نقطے مستند کا حصہ بن جائیں گے، newParent پہلے کی جگہ شروع کی جگہ کی جگہ میں،newParent بعد کی جگہ خاتمے کی جگہ کے طور پر استعمال کی جاتی ہے。

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