XML DOM getElementsByTagName() विधि

Document वस्तु संदर्भ मानक

परिभाषा और उपयोग

getElementsByTagName() विधि से निर्दिष्ट नाम के सभी एलिमेंट के एक नोड लिस्ट को प्राप्त किया जा सकता है。

व्याकरण:

getElementsByTagName(name)
पारामीटर वर्णन
name शब्दांतर, जो खोजने हेतु रूपांतरित जाने वाले टैग नाम को निर्दिष्ट करता है। मूल्य "*" सभी टैग को मेल खाता है。

प्रतिक्रिया

डॉक्यूमेंट ट्री में निर्दिष्ट टैग के Element नोड के सिर्फ पढ़ने हेतु एक सबधारक (सारथ्यतः, यह NodeList वस्तु)。प्राप्त एलिमेंट नोड की क्रमवारी उनके असली डॉक्यूमेंट में दिखाई देने की क्रमवारी है。

वर्णन

यह विधि एक NodeList वस्तुसिर्फ पढ़ने हेतु एक सबधारक के रूप में देखा जा सकता है), यह वस्तु डॉक्यूमेंट में निर्दिष्ट टैग नाम के सभी Element नोड को संग्रह करती है, उनकी क्रमवारी उनके असली डॉक्यूमेंट में दिखाई देने की क्रमवारी है。NodeList वस्तुहै, जो 'लाइव' है, अर्थात यदि डॉक्यूमेंट में निर्दिष्ट टैग नाम के एलिमेंट जोड़े या हटाए गए तो इसकी सामग्री आवश्यक अद्यतन के लिए स्वत: उन्हें अपडेट करती है。

ध्यान दें कि Element इंटरफेस एक अभिन्न विधि को परिभाषित करता है जो केवल डॉक्यूमेंट के सबदाता को ही खोजता है। अत: HTMLDocument इंटरफेस ने getElementsByName() विधिname रूपरेखा के मूल्य के आधार पर (टैग नाम के बजाय) एलिमेंट को खोजें।

उदाहरण

यहाँ पर निम्नलिखित कोड का उपयोग करके HTML डॉक्यूमेंट में सभी <h1> टैग को खोजने और इसे चकासने की जाँच की जा सकती है:

var headings = document.getElementsByTagName(")h1"")
for (var i = 0; i < headings.length; i++)  {
  var h = headings[i];
}

इंस्टांस

सभी उदाहरणों में, हम XML फ़ाइल का इस्तेमाल करेंगे books.xmlऔर JavaScript फ़ंक्शन loadXMLDoc()

नीचे दिए गए कोड फ़ेज़ "books.xml" में सभी <title> नोड के मूल्यों को दिखाता है:

xmlDoc=loadXMLDoc("/example/xdom/books.xml");
var x=xmlDoc.getElementsByTagName('title');
for (i=0;i<x.length;i++)
  {
  document.write(x[i].childNodes[0].nodeValue)
  document.write("<br />")
  }

आउटपुट:

Harry Potter
Everyday Italian
XQuery Kick Start
Learning XML

Document वस्तु संदर्भ मानक