متد document.getElementsByTagName
مثال (متد document.getElementsByTagName)
به دست آوردن عناصر درون سند، با یک نام تگ مشخص:
خودتان امتحان کنید »
در انتهای این صفحه، مثال های بیشتری آورده شده است.
تعریف و کاربرد
متد getElementByTagName()، یک مجموعه از تمام عناصری که در سند وجود دارند و دارای یک نام تگ مشخص می باشند را مانند یک شیء NodeList برمی گرداند.
شیء NodeList یک مجموعه از گره ها را مشخص می کند. گره ها می توانند به وسیله ی اندیس ها مورد دسترسی قرار بگیرند. اندیس ها نیز از 0 شروع می شوند.
نکته: مقدار "*" تمام عناصر درون سند را برمی گرداند.
نکته: شما می توانید از خصوصیت length بر روی شیء NodeList استفاده کنید، تا بتوانید تعداد عناصری که دارای یک نام تگ مشخص هستند را به دست بیاورید، سپس می توانید بر روی تمام عناصر یک حلقه ایجاد کرده و اطلاعات مورد نیاز خود را به دست بیاورید.
پشتیبانی مرورگرها
اعداد داخل جدول زیر نشان دهنده ی اولین ورژن مرورگری است که به طور کامل از این متد پشتیبانی می کند.
متد | |||||
---|---|---|---|---|---|
getElementsByTagName() | 1.0 | 6.0 | 3.0 | 3.0 | 9.5 |
نحوه استفاده
مقادیر پارامترها
پارامتر | Type | توضیحات |
---|---|---|
tagname | String |
ضروری. نام تگ عناصری که شما می خواهید به دست بیاورید. |
جزئیات تکنیکی
DOM Version: | Core Level 1 کلیه توابع و خصوصیت های شیء Document در JavaScript |
---|---|
مقدار برگشتی |
یک شیء NodeList که مشخص کننده ی یک مجموعه از عناصر با یک نام تگ مشخص می باشد.عناصر درون مجموعه برگشت داده شده مانند زمانی که درون سورس کد نمایش داده می شوند، ذخیره می شوند. |
مثال - خودتان امتحان کنید
مثال (متد document.getElementsByTagName)
فهمیدن اینکه چه تعداد عنصر <li> در سند وجود دارند(استفاده ازخصوصیت length از شیء NodeList):
خودتان امتحان کنید »
مثال (متد document.getElementsByTagName)
تغییر دادن محتوای اچ تی ام ال از اولین عنصر <p>(اندیس 0) در سند:
خودتان امتحان کنید »
مثال (متد document.getElementsByTagName)
تغییر دادن رنگ پس زمینه ی تمام عناصر <p> در سند:
var i;
for (i = 0; i < x.length; i++) {
x[i].style.backgroundColor = "red";
}
خودتان امتحان کنید »
مثال (متد document.getElementsByTagName)
استفاده از پارامتر "*" برای به دست آوردن تمام عناصر درون سند:
خودتان امتحان کنید »
آموزش های مرتبط
مرجع جاوا اسکریبت: element.getElementsByTagName()
آموزش جاوا اسکریبت: JavaScript HTML DOM Node List
کلیه توابع و خصوصیت های شیء Document در JavaScript
- نوشته شده توسط احسان عباسی
- بازدید: 6199