متد document.getElementsByTagName

مثال (متد document.getElementsByTagName)

به دست آوردن عناصر درون سند، با یک نام تگ مشخص:

var x = document.getElementsByTagName("LI");

در انتهای این صفحه، مثال های بیشتری آورده شده است.

تعریف و کاربرد

متد getElementByTagName()، یک مجموعه از تمام عناصری که در سند وجود دارند و دارای یک نام تگ مشخص می باشند را مانند یک شیء NodeList برمی گرداند.

شیء NodeList یک مجموعه از گره ها را مشخص می کند. گره ها می توانند به وسیله ی اندیس ها مورد دسترسی قرار بگیرند. اندیس ها نیز از 0 شروع می شوند.

نکته: مقدار "*" تمام عناصر درون سند را برمی گرداند.

نکته: شما می توانید از خصوصیت length بر روی شیء NodeList استفاده کنید، تا بتوانید تعداد عناصری که دارای یک نام تگ مشخص هستند را به دست بیاورید، سپس می توانید بر روی تمام عناصر یک حلقه ایجاد کرده و اطلاعات مورد نیاز خود را به دست بیاورید.

پشتیبانی مرورگرها

اعداد داخل جدول زیر نشان دهنده ی اولین ورژن مرورگری است که به طور کامل از این متد پشتیبانی می کند.

متد
getElementsByTagName()	1.0	6.0	3.0	3.0	9.5

نحوه استفاده

document.getElementsByTagName(tagname)

مقادیر پارامترها

پارامتر	Type	توضیحات
tagname	String	ضروری. نام تگ عناصری که شما می خواهید به دست بیاورید.

جزئیات تکنیکی

DOM Version:	Core Level 1 کلیه توابع و خصوصیت های شیء Document در JavaScript
مقدار برگشتی	یک شیء NodeList که مشخص کننده ی یک مجموعه از عناصر با یک نام تگ مشخص می باشد.عناصر درون مجموعه برگشت داده شده مانند زمانی که درون سورس کد نمایش داده می شوند، ذخیره می شوند.

مثال - خودتان امتحان کنید

مثال (متد document.getElementsByTagName)

فهمیدن اینکه چه تعداد عنصر <li> در سند وجود دارند(استفاده ازخصوصیت length از شیء NodeList):

var x = document.getElementsByTagName("LI").length;

خودتان امتحان کنید »

مثال (متد document.getElementsByTagName)

تغییر دادن محتوای اچ تی ام ال از اولین عنصر <p>(اندیس 0) در سند:

document.getElementsByTagName("P")[0].innerHTML = "Hello World!";

خودتان امتحان کنید »

مثال (متد document.getElementsByTagName)

تغییر دادن رنگ پس زمینه ی تمام عناصر <p> در سند:

var x = document.getElementsByTagName("P");
var i;
for (i = 0; i < x.length; i++) {
x[i].style.backgroundColor = "red";
}

خودتان امتحان کنید »

مثال (متد document.getElementsByTagName)

استفاده از پارامتر "*" برای به دست آوردن تمام عناصر درون سند:

var x = document.getElementsByTagName("*");

خودتان امتحان کنید »

آموزش های مرتبط

مرجع جاوا اسکریبت: element.getElementsByTagName()

آموزش جاوا اسکریبت: JavaScript HTML DOM Node List

کلیه توابع و خصوصیت های شیء Document در JavaScript

: نوشته شده توسط احسان عباسی; بازدید: 6009

برای درج دیدگاه، ابتدا باید وارد بیاموز شوید.

تمامی محصولات و خدمات این وبسایت، حسب مورد دارای مجوزهای لازم از مراجع مربوطه می‌باشند و فعالیت‌های این سایت تابع قوانین و مقررات جمهوری اسلامی ایران است.

مجوز نشر دیجیتال از وزرات فرهنگ و ارشاد اسلامی