طريقة getElementsByTagName() لـ HTML DOM Document

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

getElementsByTagName() تعود الطريقة بمجموعة جميع العناصر التي تحمل اسم وسم معين.

getElementsByTagName() تعود الطريقة HTMLCollection

getElementsByTagName() الخصائص قابلة للقراءة فقط.

ملاحظة:getElementsByTagName("*") تعود بمجموعة جميع العناصر في المستند.

HTMLCollection

HTMLCollection هي مجموعة من عناصر HTML تشبه اللوحة (القائمة).

يمكن الوصول إلى العناصر في المجموعة عن طريق المؤشر (بداية من 0).

length الخصائص تعود بمجموعة عدد العناصر في المجموعة.

انظر أيضًا:

طريقة getElementById()

طريقة getElementsByClassName()

طريقة querySelector()

طريقة querySelectorAll()

مجموعة HTMLCollection

مثال

مثال 1

الحصول على جميع العناصر التي تحمل اسم وسم "li":

تعريف متغير collection = document.getElementsByTagName("li");

تجربة شخصية

مثال 2

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

تعريف متغير collection = document.getElementsByTagName("*");

تجربة شخصية

مثال 3

تغيير HTML الداخلي لعنصر <p> الأول في المستند:

document.getElementsByTagName("p")[0].innerHTML = "Hello World!";

تجربة شخصية

مثال 4

عدد عناصر <li> في المستند:

تعريف متغير numb = document.getElementsByTagName("li").length;

تجربة شخصية

مثال 5

تغيير لون الخلفية لجميع عناصر <p>:

للحصول على النصوص في النسخة البسيطة من JSON، يرجى النقر هنا:
للمحصول على النصوص في النسخة البسيطة من JSON، يرجى النقر هنا:
  collection[i].style.backgroundColor = "red";
}

تجربة شخصية

النص

document.getElementsByTagName(tagNameالجملة

)

) الوصف
tagName الم 参数

القيمة المطلوبة. اسم العنصر.

النوع الوصف
عنصر

عنصر HTMLCollection.

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

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

تفاصيل تقنية

سيقوم هذا الطريقة بإرجاع العنصر NodeList (يمكن معالجته كعدد فقطقراءة)، ويحتوي هذا العنصر على جميع العناصر Element التي تحتوي على الاسم المحدد في المستند، ويكون ترتيبها هو نفس الترتيب الذي يظهر بهم في المستند المصدر.

هذا العنصر NodeList هو "الحي"، أي إذا تم إضافة أو حذف عنصر يحمل نفس الاسم في المستند، فإن محتواه يتم تحديثه تلقائيًا.

المستندات HTML لا تفرق بين الحروف الكبيرة والصغيرة، لذا يمكن استخدام أي نمط حرفي لتحديد الاسم. tagName، ويبحث عن جميع العناصر التي تحمل نفس الاسم في المستند، بغض النظر عن النمط الحرفي (الحروف الكبيرة أو الصغيرة) الذي تم استخدامه في المستند المصدر. ولكن المستندات XML تفرق بين الحروف الكبيرة والصغيرة،tagName تنطبق فقط على العناصر التي تحتوي على نفس الاسم في النص المصدر، بغض النظر عن النمط الحرفي (الحروف الكبيرة أو الصغيرة).

نصيحة:تعريف واجهة Element طريقة同名، ويبحث فقط عن فرع المستند. بالإضافة إلى ذلك، تعريف واجهة HTMLDocument طريقة getElementByName()، ويبحث عن العناصر بناءً على قيمة الخاصية name (بدلاً من الاسم المكتوب).

دعم المتصفح

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

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

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

الصفحات ذات الصلة

دليل مرجعي JavaScript:element.getElementsByTagName()

دروس JavaScript:قائمة العناصر HTML DOM لـ JavaScript