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 और इसका दायरा अलग-अलग Document वस्तु से बनाया गया है।
RangeException.BAD_BOUNDARYPOINTS_ERR
वर्तमान दायरा का एक हिस्सा नोड (Text नोड को छोड़कर) चुना गया है, इसलिए दस्तावेज़ के इस क्षेत्र को घेर नहीं सकता है。
RangeException.INVALID_NODE_TYPE_ERR
newParent डॉक्यूमेंट, डॉक्यूमेंटFragment, डॉक्यूमेंटType, Attr, Entity या Notation नोड हैं।
वर्णन
इस विधि इस वस्तु के मौजूदा मूल नोड को newParentऔर newParent दस्तावेज़ में किसी क्षेत्र की शुरुआत स्थान में घुसाया जा सकता है, उदाहरण के लिए, दस्तावेज़ के एक क्षेत्र को <div> या <span> एलीमेंट में डालने के लिए इस विधि का उपयोग किया जा सकता है。
यदि newParent यदि यह दस्तावेज़ के एक हिस्से का हिस्सा है, तो यह पहले से दस्तावेज़ से मिटा दिया जाएगा, इसके सबसे छोटे बच्चे भी छोड़ दिए जाएंगे।जब इस विधि का परिणाम वापस आता है, तब यह दायरा newParent पहले की स्थिति शुरुआत बिंदु है,newParent बाद की स्थिति अंत बिंदु है।
