مستند HTML DOM ، getElementsByName ()
مثال
احصل على جميع العناصر بالاسم "fname":
let collection = document.getElementsByName("fname");
المزيد من الأمثلة "جربها بنفسك" أدناه.
التعريف والاستخدام
تقوم getElementsByName()
الطريقة بإرجاع مجموعة من العناصر باسم محدد.
تقوم getElementsByName()
الطريقة بإرجاع مجموعة HTMLCollection .
أنظر أيضا:
أسلوب getElementById () المستند
أسلوب getElementsByTagName () المستند
أسلوب getElementsByClassName () المستند
أسلوب استعلام المستند المحدد ()
بناء الجملة
document.getElementsByName(name)
المعلمات
Parameter | Description |
name | Required. The name value of the elements. |
قيمة الإرجاع
نوع | وصف |
هدف | كائن مجموعة HTML . مجموعة من العناصر بالاسم المحدد. يتم فرز العناصر كما تظهر في المستند. |
مزيد من الأمثلة
عدد العناصر التي تحمل الاسم = "حيوان":
let num = document.getElementsByName("animal").length;
حدد جميع عناصر <input> بالنوع = "checkbox" التي لها اسم "حيوان":
const collection = document.getElementsByName("animal");
for (let i = 0; i < collection.length; i++) {
if (collection[i].type == "checkbox") {
collection[i].checked = true;
}
}
دعم المتصفح
document.getElementsByName()
هي ميزة DOM المستوى 1 (1998).
إنه مدعوم بالكامل في جميع المتصفحات:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |