روش getElementsByName() از مستند DOM HTML

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

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

getElementsByName() این روش بازگشتی NodeList.

NodeList

NodeList یک مجموعه‌ی گره‌های شبیه به آرایه (لیست) است.

می‌توان به گره‌های موجود در لیست از طریق شماره‌ی شروع از 0 به صورت شماراوزی دسترسی داشت.

length تعداد گره‌های موجود در لیست بازگشتی属性.

لطفاً به بخش دیگری مراجعه کنید:

مетод getElementById()

مетод getElementsByTagName()

مетод getElementsByClassName()

مетод querySelector()

مетод querySelectorAll()

دستورالعمل NodeList

مثال

مثال 1

تمام عناصر با نام "fname" را دریافت کنید:

let elements = document.getElementsByName("fname");

آزمایش کنید

مثال 2

تعداد عناصر با name="animal" را بازگرداند:

let num = document.getElementsByName("animal").length;

آزمایش کنید

مثال 3

تمام عناصر <input> با type="checkbox" و نام "animal" را بررسی کنید:

const collection = document.getElementsByName("animal");
for (let i = 0; i < collection.length; i++) {
  if (collection[i].type == "checkbox") {
    collection[i].checked = true;
  }
}

آزمایش کنید

نحوه استفاده

document.getElementsByName(name)

پارامتر

پارامتر توضیح
name ضروری. مقدار attribute name عناصر.

مقدار بازگشتی

نوع توضیح
عنصر

عنصر NodeList.

گروهی از عناصر با نام مشخص.

بر اساس ترتیب ظاهر شدن عناصر در مستند مرتب می‌شود.

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

document.getElementsByName() این یک ویژگی DOM Level 1 (1998) است.

همه مرورگرها از آن پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی 9-11 پشتیبانی پشتیبانی پشتیبانی پشتیبانی