XML DOM طريقة getElementsByTagName()
التعريف والاستخدام
يمكن أن يعيد طريقة getElementsByTagName() قائمة العقد التي تحتوي على اسم معين.
النحو:
getElementsByTagName(اسم)
| الم 参数 | وصف |
|---|---|
| اسم | قيمة النص،تحدد العنصر الذي يجب البحث عنه.القيمة "*" تتطابق مع جميع العناصر. |
القيمة المعدة
عدد قابلة للقراءة لعناصر Element التي تحتوي على علامة معينة في شجرة المستند (تقنيًا،هي مثل NodeList()).سيكون ترتيب عناصر العقد الناتجة هو نفس الترتيب الذي يظهر به في المستند الأصلي.
شرح
سيقوم هذا الطريقة بتقديم مثل NodeList(يمكن معالجته كعدد قابلة للقراءة)،يحتوي هذا المثل على جميع العناصر Element التي تحتوي على اسم العنصر المحدد في المستند،وترتيبها هو نفس الترتيب الذي يظهر به في المستند الأصلي.مثل NodeListهي "حية"،بمعنى أن إذا تم إضافة أو حذف عنصر يحمل نفس اسم العنصر المحدد في المستند،سيتم تحديث المحتوى تلقائيًا.
لاحظ،يحدد واجهة Element طريقة ذات نفس الاسم،تقوم بالبحث فقط عن فرع المستند. طريقة getElementsByName()،البحث عن العناصر بناءً على قيمة الخاصية name (بدلاً من اسم العنصر).
مثال
يمكن استخدام الكود التالي للبحث عن مرور جميع العناصر <h1> في مستند HTML:
var headings = document.getElementsByTagName(")h1"(")}
for (var i = 0; i < headings.length; i++) {
var h = headings[i];
}
مثال
في جميع الأمثلة، سنستخدم ملف XML books.xml، بالإضافة إلى وظائف JavaScript loadXMLDoc().
يمكن لهذا جزء من الكود التالي عرض قيم جميع عناصر <title> في ملف "books.xml":
xmlDoc=loadXMLDoc("/example/xdom/books.xml");
var x=xmlDoc.getElementsByTagName('title');
for (i=0;i<x.length;i++)
{
document.write(x[i].childNodes[0].nodeValue)
document.write("<br />")
}
الناتج:
Harry Potter Everyday Italian XQuery Kick Start تعلم XML
