XML DOM surroundContents() ਮੱਥਦਾਨ
ਪਰਿਭਾਸ਼ਾ ਅਤੇ ਵਰਤੋਂ
surroundContents() ਮੱਥਦਾਨ ਦੇ ਨਿਰਦਿਸ਼ਟ ਨੋਡ ਨਾਲ ਦਾਇਰੇ ਦੇ ਸਮਾਵੇਸ਼ੀ ਸਮੱਸਾਗਰ ਨੂੰ ਘੇਰ ਦਿੰਦਾ ਹੈ。
ਸਫ਼ਟਵੇਰਕਰਣ
surroundContents(newParent)
ਪੈਰਾਮੀਟਰ
| ਪੈਰਾਮੀਟਰ | وصف |
|---|---|
| newParent | ਹੋਵੇਗਾ ਨਵੇਂ ਦਾਇਰੇ ਦੇ ਸਮਾਵੇਸ਼ੀ ਨੋਡ ਦਾ ਨਵਾਂ ਪੈਰੈਂਟ ਨੋਡ |
ਫੇਰ ਕਰ ਦਿੰਦਾ ਹੈ
ਇਹ ਮੱਥਦਾਨ ਹੇਠ ਲਿਖੇ ਕੋਡ ਵਾਲੇ ਅਨੁਭਵ ਨੂੰ ਫੇਰ ਕਰ ਦਿੰਦਾ ਹੈ DOMException ਅਨੁਭਵਜਾਂ RangeException ਅਨੁਭਵ：
DOMException.HIERARCHY_REQUEST_ERR
ਮੌਜੂਦਾ ਦਾਇਰੇ ਦੀ ਸ਼ੁਰੂਆਤ ਦਾ ਸਮਾਵੇਸ਼ੀ ਨੋਡ ਦੇ ਕੋਲ ਉਪ ਨੋਡ ਨਹੀਂ ਹੋ ਸਕਦੇ, ਨਹੀਂ ਹੋ ਸਕਦੇ newParent ਦਾ ਉਪ ਨੋਡ ਹੈ ਜਾਂ newParent ਇੱਕ ਸਮਾਵੇਸ਼ੀ ਨੋਡ ਦਾ ਪੂਰਵਜ ਨੋਡ ਹੈ。
DOMException.NO_MODIFICATION_ALLOWED_ERR
موجودہ وسیعہ کا آخری نقطہ کا پرانا نود خواندہ ہوتا ہے، لہذا اس میں داخل کردینا نہیں کرسکتا۔
DOMException.WRONG_DOCUMENT_ERR
newParent اور اس کا وسیعہ مختلف دوکومن وسیعوں سے تیار کیا گیا ہے۔
RangeException.BAD_BOUNDARYPOINTS_ERR
موجودہ وسیعہ کا حصہ کسی نود کو چنایا ہوا ہے (Text نود کے علاوہ)، لہذا اس دوکومن کے اس علاقے کو چننا نہیں کرسکتا۔
RangeException.INVALID_NODE_TYPE_ERR
newParent دوکومن، دوکومن فراگمنٹ، دوکومن تیپ، اٹر، اینٹیٹی یا ناتیشن نودز کا نود ہوتا ہے。
وصف
یہ طریق آپ کی موجودہ وسیعہ کی ماڈرن کو newParent، بعد میں newParent دوکومن میں کسی وسیعہ کا شروع کا مقام میں باندھا جائے گا۔ مثلاً، دوکومن کا کسی علاقے کو <div> یا <span> عناصر میں باندھا جائے گا، تو اس طریق کا استعمال کرسکتے ہیں۔
اگر newParent اگر یہ کچھ مستند کا حصہ ہے تو اسے پہلے سے مستند سے الگ کردیا جائے گا، اس کا بچوں کا بھی مستند الگ کردیا جائے گا۔ جب اس طریق سے واپس آنے کا وقت آئے گا تو اس دوسرے مستند کا وسیعہ، newParent پہلے کا مقام شروع کے نقطہ کے طور پر ہوگا،newParent بعد کا مقام آخری نقطہ کے طور پر ہوگا。
