متد getElementsByTagName() در HTML DOM

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

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

تعریف دستور زبان

document.getElementsByTagName(tagname)

توضیحات

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

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

توضیحات و نظرات

توجه:مطالعه: رشته‌ای که به متد getElementsByTagName() ارسال می‌شود می‌تواند بدون توجه به بزرگ یا کوچک بودن حروف باشد.

مثال

مثال 1

<html>
<head>
<script type="text/javascript">
function getElements()
  {
  var x=document.getElementsByTagName("input");
  alert(x.length);
  }
</script>
</head>
<body>
<input name="myInput" type="text" size="20" /><br />
<input name="myInput" type="text" size="20" /><br />
<input name="myInput" type="text" size="20" /><br />
<br />
<input type="button" onclick="getElements()"
value="چند عنصر ورودی؟" />
</body>
</html>

مثال 2

می‌توان از روش getElementsByTagName() برای دریافت لیستی از هر نوع عنصر HTML استفاده کرد. به عنوان مثال، کد زیر تمام جدول‌های مستند را می‌گیرد:

var tables = document.getElementsByTagName("table");
alert ("این مستند شامل " + tables.length + " جدول دارد");

مثال 3

اگر شما ساختار مستند را به خوبی می‌شناسید، می‌توانید از روش getElementsByTagName() برای دسترسی به یک عنصر خاص مستند استفاده کنید. به عنوان مثال، کد زیر چهارمین پاراگراف مستند را می‌گیرد:

var myParagragh = document.getElementsByTagName("p")[3];

هرچند، ما همچنان معتقدیم که اگر نیاز به عملکرد بر روی یک عنصر خاص دارید، استفاده از روش getElementById() مؤثرتر خواهد بود.