XML DOM روش getElementsByTagName()

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

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

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

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

توضیحات

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

توجه داشته باشید که Document Interface نیز روش getElementsByTagName() را تعریف کرده است، که شبیه به این روش است اما به جای جستجو در فرزندان یک عنصر، تمام مدارک را جستجو می‌کند.

مثال

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

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

xmlDoc=loadXMLDoc("books.xml");
x=xmlDoc.getElementsByTagName('title');
برای (i=0; i<x.length; i++)
{
document.write(x[i].childNodes[0].nodeValue);
document.write("<br />");
}

خروجی کد بالا:

Everyday Italian
Harry Potter
XQuery Kick Start
Learning XML