الفرق بين المراجعتين لصفحة: «JavaScript/Document/getElementsByName»
< JavaScript | Document
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>Document.getElementsByName()</code>}}</noinclude> | <noinclude>{{DISPLAYTITLE:<code>Document.getElementsByName()</code>}}</noinclude> | ||
يُعيد التّابع <code>Document.getElementsByName()</code> قائمة العقد ذات الخاصيّة <code>name</code> المعطاة في مستند | يُعيد التّابع <code>Document.getElementsByName()</code> قائمة العقد ذات الخاصيّة <code>name</code> المعطاة في مستند <nowiki/>[[HTML]]. | ||
==البنية العامة== | ==البنية العامة== | ||
| سطر 7: | سطر 7: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===<code>elements</code>=== | ===<code>elements</code>=== | ||
كائن حيّ من النّوع <code> | كائن حيّ من النّوع <code>NodeList</code> يُمثّل مجموعة العناصر التي وُجدت. | ||
===<code>name</code>=== | ===<code>name</code>=== | ||
| سطر 33: | سطر 33: | ||
==ملاحظات== | ==ملاحظات== | ||
الخاصيّة <code>name</code> تعمل فقط على مستندات HTML و XHTML. يُعيد التّابع كائنًا حيًّا من النّوع <code> | الخاصيّة <code>name</code> تعمل فقط على مستندات HTML و XHTML. يُعيد التّابع كائنًا حيًّا من النّوع <code>NodeList</code> يحتوي مجموعة العناصر ذات الاسم الذي يوافق المعامل المعطى، مثل عناصر <code>[[HTML/meta|<meta>]]</code> و <code>[[HTML/object|<object>]]</code> أو حتى إن كانت الخاصيّة <code>name</code> في عنصر لا يدعم هذه الخاصيّة. | ||
يعمل التّابع <code>getElementsByName</code> باختلافٍ في مختلف المتصفّحات. ففي النّسخ التي سبقت النّسخة 10 من متصفّح IE، فإنّ التّابع يعيد كذلك العناصر ذات المعرّف (الخاصيّة id) الموافق للقيمة المعطاة. لذا يجب أن تحذر من استخدام نفس القيمة كاسمٍ ومُعرّفٍ في نفس الوقت. | يعمل التّابع <code>getElementsByName</code> باختلافٍ في مختلف المتصفّحات. ففي النّسخ التي سبقت النّسخة 10 من متصفّح IE، فإنّ التّابع يعيد كذلك العناصر ذات المعرّف (الخاصيّة id) الموافق للقيمة المعطاة. لذا يجب أن تحذر من استخدام نفس القيمة كاسمٍ ومُعرّفٍ في نفس الوقت. | ||
المراجعة الحالية بتاريخ 14:23، 7 أكتوبر 2022
يُعيد التّابع 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.