سبد (0)

متد 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 Reference کلیه توابع و خصوصیت های شیء Document در JavaScript


تمامی محصولات و خدمات این وبسایت، حسب مورد دارای مجوزهای لازم از مراجع مربوطه می‌باشند و فعالیت‌های این سایت تابع قوانین و مقررات جمهوری اسلامی ایران است.
logo-samandehi مجوز نشر دیجیتال از وزرات فرهنگ و ارشاد اسلامی پرداخت آنلاین -  بانک ملت معرفی بیاموز در شبکه سه