طريقة getElementsByTagName() لـ HTML DOM Document
- الصفحة السابقة getElementsByName()
- الصفحة التالية hasFocus()
- العودة إلى الطبقة السابقة مستندات Documents HTML DOM
التعريف والاستخدام
getElementsByTagName()
تعود الطريقة بمجموعة جميع العناصر التي تحمل اسم وسم معين.
getElementsByTagName()
تعود الطريقة HTMLCollection
getElementsByTagName()
الخصائص قابلة للقراءة فقط.
ملاحظة:getElementsByTagName("*")
تعود بمجموعة جميع العناصر في المستند.
HTMLCollection
HTMLCollection هي مجموعة من عناصر HTML تشبه اللوحة (القائمة).
يمكن الوصول إلى العناصر في المجموعة عن طريق المؤشر (بداية من 0).
length الخصائص تعود بمجموعة عدد العناصر في المجموعة.
انظر أيضًا:
مثال
مثال 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
- الصفحة السابقة getElementsByName()
- الصفحة التالية hasFocus()
- العودة إلى الطبقة السابقة مستندات Documents HTML DOM