XML DOM getElementsByTagName() method

منوی مرجع Document

تعریف و استفاده

method getElementsByTagName() می‌تواند یک لیست از همه عناصر با نام مشخصی را بازگرداند.

نحوه استفاده:

getElementsByTagName(name)
پارامتر توضیح
name مقدار رشته‌ای، که نام برچسبی را که باید جستجو شود تعیین می‌کند. مقدار "*" تمام برچسب‌ها را تطبیق می‌دهد.

مقدار بازگشتی

آرایه فقط خوانا از Element‌های مستند با برچسب مشخصی در درخت مستند (تکنیکی‌تر بگوییم که) مجموعه NodeList()). ترتیب عناصر نهایی بر اساس ترتیب آن‌ها در مستند منبع است.

توضیح

این روش یک مجموعه NodeList(می‌توان آن را به عنوان یک آرایه فقط خوانا در نظر گرفت)، این مجموعه شامل تمام Element‌های مستند با نام برچسب مشخصی است که ترتیب آن‌ها در مستند منبع ظاهر شده است.مجموعه NodeListزنده است، یعنی اگر در مستند عناصر با نام برچسب مشخصی اضافه یا حذف شوند، محتوای آن‌ها به طور خودکار به‌روزرسانی خواهد شد.

توجه داشته باشید که Element Interface یک روش با نام مشابه را تعریف کرده است که فقط در زیر درخت مستند جستجو می‌کند. علاوه بر این، HTMLDocument Interface مетод getElementsByName()، بر اساس ارزش ویژگی name (نه نام برچسب) عناصر را جستجو کنید.

مثال

ممکن است از کد زیر برای جستجو و جلوگیری از تمام عناوین <h1> در مستند HTML استفاده شود:

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

مثال

در همه مثال‌ها، ما از فایل XML استفاده خواهیم کرد books.xml، و توابع JavaScript loadXMLDoc().

کد زیر می‌تواند همه مقادیر عناصر <title> در فایل "books.xml" را نمایش دهد:

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

TIY

getElementsByTagName() - دریافت مقدار یک گره مشخص

منوی مرجع Document