Document.getElementsByName()‎

من موسوعة حسوب

يُعيد التّابع 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) الموافق للقيمة المعطاة. لذا يجب أن تحذر من استخدام نفس القيمة كاسمٍ ومُعرّفٍ في نفس الوقت.

انظر أيضًا

مصادر ومواصفات