Document.getElementsByName()
< JavaScript | Document
يُعيد التّابع Document.getElementsByName()
قائمة العقد ذات الخاصيّة name
المعطاة في مستند 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
.