طريقة 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 للعنصر.

القيمة المعدلة

النوع الوصف
الشكل

مثل NodeList.

مجموعة العناصر التي تحتوي على الاسم المحدد.

يتم ترتيب العناصر وفقًا للترتيب الذي يظهر فيه العناصر في المستند.

دعم المتصفحات

document.getElementsByName() هو خاصية DOM Level 1 (1998).

يدعمه جميع المتصفحات:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
الدعم 9-11 الدعم الدعم الدعم الدعم