أحدث البرامج التعليمية وتطوير الشبكة
 

HTML DOM getElementsByName() Method

<كائن المستند

مثال

الحصول على جميع العناصر مع اسم محدد:

var x = document.getElementsByName("fname");
انها محاولة لنفسك »

أكثر "Try it Yourself" الأمثلة أدناه.


تعريف والاستخدام

و getElementsByName() الأسلوب بإرجاع مجموعة من كافة العناصر في وثيقة مع الاسم المحدد (the value of the name attribute) ، ككائن NodeList.

يمثل الكائن NodeList مجموعة من العقد. العقد يمكن الوصول إليها عن طريق الأرقام القياسية. يبدأ المؤشر عند 0.

نصيحة: يمكنك استخدام طول خاصية الكائن NodeList لتحديد عدد من العناصر مع اسم معين، ثم يمكنك أن يتكرر خلال كافة العناصر واستخراج المعلومات التي تريدها.

ملاحظة: في HTML5، و "name" تم إهمال السمة، وقد يحل محلها "id" سمة لكثير من العناصر. استخدام وثيقة. getElementById() طريقة حيث أنه من المناسب. ننظر أيضا في getElementsByClassName() و getElementsByTagName() الأساليب.


دعم المتصفح

طريقة
getElementsByName() نعم فعلا نعم فعلا نعم فعلا نعم فعلا نعم فعلا

بناء الجملة

document.getElementsByName( قيم معلمة
معامل اكتب وصف
name String مطلوب. على name قيمة سمة من العنصر الذي تريد الوصول / التلاعب

تفاصيل تقنية

صفحة DOM: المستوى الأساسي كائن 1 الوثيقة
قيمة الإرجاع: كائن NodeList، تمثل مجموعة من العناصر مع الاسم المحدد. يتم فرز العناصر في المجموعة عاد كما تظهر في شفرة المصدر.

أمثلة

مزيد من الأمثلة

مثال

معرفة عدد العناصر هناك في الوثيقة التي تحتوي على سمة الاسم مع قيمة "animal" (باستخدام الخاصية طول الكائن NodeList):

var x = document.getElementsByName("animal").length;
انها محاولة لنفسك »

مثال

تحقق من كل <input> العناصر مع نوع = "مربع" في الوثيقة التي تحتوي على سمة الاسم مع قيمة "animal" :

var x = document.getElementsByName("animal");
var i;
for (i = 0; i < x.length; i++) {
    if (x[i].type == "checkbox") {
        x[i].checked = true;
    }
}
انها محاولة لنفسك »

<كائن المستند