Document.getElementsByName()
< JavaScript | Document
يُعيد التّابع Document.getElementsByName() قائمة العقد ذات الخاصيّة name المعطاة في مستند (X)HTML.
البنية العامة
elements = document.getElementsByName(name)
القيم
elements
كائن حيّ من النّوع NodeList يُمثّل مجموعة العناصر التي وُجدت.
name
قيمة الخاصيّة name الخاصّة بالعنصر.
مثال
<!DOCTYPE html>
<html lang="en">
<head>
...
</head>
<body>
<form name="up"><input type="text"></form>
<div name="down"><input type="text"></div>
<script>
var up_forms = document.getElementsByName("up");
console.log(up_forms[0].tagName); // "FORM"
</script>
</body>
</html>
ملاحظات
الخاصيّة name تعمل فقط على مستندات HTML وXHTML. يُعيد التّابع كائنًا حيًّا من النّوع NodeList يحتوي مجموعة العناصر ذات الاسم الذي يوافق المعامل المعطى، مثل عناصر <meta> و<object> أو حتى إن كانت الخاصيّة name في عنصر لا يدعم هذه الخاصيّة.
يعمل التّابع getElementsByName باختلافٍ في مختلف المتصفّحات. ففي النّسخ التي سبقت النّسخة 10 من متصفّح IE، فإنّ التّابع يعيد كذلك العناصر ذات المعرّف (الخاصيّة id) الموافق للقيمة المعطاة. لذا يجب أن تحذر من استخدام نفس القيمة كاسمٍ ومُعرّفٍ في نفس الوقت.
انظر أيضًا
Document.getElementById()للحصول على مرجع للعنصر حسب مُعرّفهid.Document.getElementsByTagName()للحصول على مراجع للعناصر حسب اسم الوسم المعطى.Document.querySelector()لاستعمال المُحدِّدات التي تستعمل استعلامات مثل'div.myclass'.