XML DOM - रेंज ऑब्जेक्ट

रेंज ऑब्जेक्ट डॉक्यूमेंट में के लगातार क्षेत्र को प्रतिनिधित्व करता है。

रेंज ऑब्जेक्ट

रेंज ऑब्जेक्ट डॉक्यूमेंट के लगातार क्षेत्र को प्रतिनिधित्व करता है, जैसे उपयोगकर्ता ब्राउज़र विंडो में माउस से चयनित क्षेत्र को खींचता है।

यदि कोई इंप्लीमेंट रेंज मॉड्यूल का समर्थन करता है, तो डॉक्यूमेंट ऑब्जेक्टको परिभाषित करती है createRange() विधिको बुला दें, इससे नए रेंज ऑब्जेक्ट को बनाया जा सकता है।

ध्यान:आईई ने असमरूप डॉक्यूमेंट.createRange() विधि परिभाषित की है, जो रेंज इंटरफेस के समान ऑब्जेक्ट वापस देती है, लेकिन असमरूप है।

रेंज इंटरफेस ने डॉक्यूमेंट 'सेलेक्ट' के क्षेत्र के लिए बहुत सी विधियां परिभाषित की है, इसके अलावा कुछ विधियां भी उपयोग में लाई जाती हैं जो चिपकान और काप कार्यों के लिए उपयोग की जाती हैं।

रेंज इंटरफेस की गुणवत्ताएं रेंज के किनारा नोड और ऑफसेट को प्राप्त करने के लिए विधियां प्रदान करती हैं। इसके विधियां रेंज के किनारा को सेट करने के लिए प्रदान करती हैं। ध्यान दें कि रेंज के किनारा को डॉक्यूमेंट या डॉक्यूमेंटफ्रैगमेंट ऑब्जेक्टमें के नोड। एक रेंज के किनारा बिंदु निर्धारित होने के बाद, deleteContents()、extractContents()、cloneContents() और insertNode() विधियों का उपयोग करके काप, प्रतिलिपि और चिपकान की कार्यों को कर सकते हैं。

जब डॉक्यूमेंट को प्रविष्टि या निष्क्रिय करने के कार्यों से बदला जाता है, तो डॉक्यूमेंट के एक हिस्से को प्रतिनिधित्व करने वाले सभी रेंज ऑब्जेक्ट बदलेंगे (आवश्यकता पड़े तो), ताकि उनके किनारा बिंदु प्रभावी बने और वे (जितना संभव हो) उसी डॉक्यूमेंट की सामग्री को प्रतिनिधित्व करें।

शब्द: रेंज, किनारा बिंदु और ऑफसेट

एक रेंज के पास दो किनारा बिंदु होते हैं, अर्थात एक शुरूआती बिंदु और एक समाप्ती बिंदु। हर किनारा बिंदु एक नोड और उस नोड के ऑफसेट के द्वारा निर्दिष्ट किया जाता है। यह नोड आमतौर पर एलिमेंट नोड、डॉक्यूमेंट नोडया टेक्स्ट नोडएलिमेंट नोड और डॉक्यूमेंट नोड के लिए, ऑफसेट इस नोड के उपनोड को कहते हैं। ऑफसेट 0 का मतलब है कि किनारा बिंदु इस नोड के पहले उपनोड के पहले है। ऑफसेट 1 का मतलब है कि किनारा बिंदु इस नोड के पहले उपनोड के बाद, दूसरे उपनोड के पहले है। लेकिन यदि किनारा नोड टेक्स्ट नोड है, तो ऑफसेट टेक्स्ट में दो अक्षरों के बीच की स्थिति को कहता है।

Range ऑब्जेक्ट के स्थायी

इन स्थायी इसके द्वारा Range ऑब्जेक्ट के बीच बैंडरी पाइंट्स को कैसे तुलना करना है इसे निर्दिष्ट करते हैं

वे compareBoundaryPoints() तरीके के how पारामीटर की वैध मान:

स्थायी वर्णन
START_TO_START निर्दिष्ट Range के शुरू करने के बिंदु को वर्तमान Range के शुरू करने के बिंदु से तुलना करें
START_TO_END निर्दिष्ट Range के शुरू करने के बिंदु को वर्तमान Range के समाप्ति करने के बिंदु से तुलना करें
END_TO_END निर्दिष्ट Range के समाप्ति करने के बिंदु को वर्तमान Range के समाप्ति करने के बिंदु से तुलना करें
END_TO_START निर्दिष्ट Range के समाप्ति करने के बिंदु को वर्तमान Range के शुरू करने के बिंदु से तुलना करें

Range ऑब्जेक्ट के गुण

ध्यान:सभी गुण लिखित हैं, इन गुणों को सेट करके रेंज के शुरू करने के बिंदु और समाप्ति करने के बिंदु को बदलना संभव नहीं है, इसके लिए setEnd() और setStart() तरीके को बुलाना होगा

ध्यान:detach() तरीके को बुलाने के बाद, इन गुणों की किसी भी पढ़ने की कोशिश पर INVALID_STATE_ERR कोड वाला एरर फेंका जाएगा DOMException त्रुटि。

गुण वर्णन
collapsed यदि रेंज के शुरू करने के बिंदु और समाप्ति करने के बिंदु दस्तावेज़ के एक ही स्थान पर हैं तो true है, अर्थात रेंज खाली है या फिर ढीला है
commonAncestorContainer रेंज के शुरू करने के बिंदु और समाप्ति करने के बिंदु (अर्थात उनके पूर्ववर्ती नोड) के गहराई से निहित Document नोड
endContainer रेंज के समाप्ति करने के बिंदु को शामिल करने वाला Document नोड
endOffset endContainer में समाप्ति करने के बिंदु की स्थिति
startContainer रेंज के शुरू करने के बिंदु को शामिल करने वाला Document नोड
startOffset startContainer में शुरू करने के बिंदु की स्थिति

Range ऑब्जेक्ट के तरीके

ध्यान:यदि किसी Range के detach() तरीके को बुलाया गया है तो आगे Range ऑब्जेक्ट के किसी भी तरीके को बुलाने पर INVALID_STATE_ERR कोड वाला एरर फेंका जाएगा DOMException त्रुटि。

तरीका वर्णन
cloneContents() नया DocumentFragment ऑब्जेक्ट वापस देता है जो इस स्कोप को प्रतिनिधित्व करता है और इस स्कोप के दस्तावेज़ क्षेत्र की प्रतिलिपि को शामिल करता है。
cloneRange() एक नया Range ऑब्जेक्ट बनाएं जो वर्तमान Range ऑब्जेक्ट के समान दस्तावेज़ क्षेत्र को प्रतिनिधित्व करता है。
collapse() इस दायरे के बोर्डर पॉइंट को समायोजित करें, ताकि वे एक साथ आएं।
compareBoundaryPoints() निर्दिष्ट दायरे के बोर्डर पॉइंट और वर्तमान दायरे के बोर्डर पॉइंट को तुलना करें, -1, 0 और 1 वापस करें, जो उसके पहले पारामीटर द्वारा निर्दिष्ट होगा, जिसका मूल्य वर्तमान रूपरेखा में परिभाषित किए गए अधिकार के एक होना चाहिए।
deleteContents() वर्तमान Range ऑब्जेक्ट द्वारा प्रस्तुत दस्तावेज़ क्षेत्र को मिटाएं。
detach() यह निर्देश करता है कि निर्धारित दायरे का उपयोग नहीं किया जाएगा, इसलिए ट्रैकिंग बंद कर सकते हैं। यदि इस दायरे की इस विधि को आगे के अवसर पर आमंत्रित किया जाए, तो अगले दायरे की किसी भी विधि को आमंत्रित करने पर INVALID_STATE_ERR कोड वाली त्रुटि फेंकी जाएगी。 DOMException त्रुटि。
extractContents() वर्तमान दायरे द्वारा प्रस्तुत दस्तावेज़ क्षेत्र को मिटाएं और उस क्षेत्र के सामग्री को DocumentFragment ऑब्जेक्ट के रूप में वापस करें। यह और cloneContents() तथा deleteContents() विधियों के समय-समय उपयोग के साथ बहुत मिलती-जुलती है।
insertNode() निर्दिष्ट नोड को दस्तावेज़ दायरे की शुरुआती बिंदु में जोड़ें。
selectNode() इस दायरे के बोर्डर पॉइंट को सेट करें ताकि यह निर्दिष्ट नोड और इसके सभी वंशज को शामिल करे।
selectNodeContents() इस दायरे के बोर्डर पॉइंट को सेट करें ताकि यह निर्दिष्ट नोड के वंशज को शामिल करे, लेकिन निर्दिष्ट नोड को नहीं करे।
setEnd() इस दायरे की समाप्ती बिंदु को निर्दिष्ट नोड और आवर्तन से सेट करें。
setEndAfter() इस दायरे की समाप्ती बिंदु को निर्दिष्ट नोड के बाद निकटतम बिंदु में सेट करें。
setEndBefore() इस दायरे की समाप्ती बिंदु को निर्दिष्ट नोड से पहले निकटतम बिंदु में सेट करें。
setStart() इस दायरे की शुरुआती बिंदु को निर्दिष्ट नोड में निर्दिष्ट आवर्तन से सेट करें。
setStartAfter() इस दायरे की शुरुआती बिंदु को निर्दिष्ट नोड के बाद निकटतम बिंदु में सेट करें。
setStartBefore() इस दायरे की शुरुआती बिंदु को निर्दिष्ट नोड से पहले निकटतम बिंदु में सेट करें。
surroundContents() निर्दिष्ट नोड को दस्तावेज़ दायरे की शुरुआती बिंदु में जोड़ें, फिर दायरे में सभी नोड के मूल नोड को नए जोड़े गए नोड के वंशज के रूप में रखें।
toString() इस दायरे के द्वारा प्रस्तुत दस्तावेज़ क्षेत्र का शुद्ध पाठ सामग्री प्रस्तुत करें।