الفرق بين المراجعتين لصفحة: «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> المعطاة في مستند HTML. | ||
==البنية العامة== | ==البنية العامة== | ||
| سطر 6: | سطر 6: | ||
elements = document.getElementsByName(name) | elements = document.getElementsByName(name) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===<code>elements</code>=== | |||
كائن حيّ من النّوع <code>[[JavaScript/NodeList|NodeList]]</code> يُمثّل مجموعة العناصر التي وُجدت. | كائن حيّ من النّوع <code>[[JavaScript/NodeList|NodeList]]</code> يُمثّل مجموعة العناصر التي وُجدت. | ||
===<code>name</code>=== | |||
قيمة الخاصيّة <code>name</code> الخاصّة بالعنصر. | قيمة الخاصيّة <code>name</code> الخاصّة بالعنصر. | ||
| سطر 34: | سطر 33: | ||
==ملاحظات== | ==ملاحظات== | ||
الخاصيّة <code>name</code> تعمل فقط على مستندات HTML | الخاصيّة <code>name</code> تعمل فقط على مستندات HTML و XHTML. يُعيد التّابع كائنًا حيًّا من النّوع <code>[[JavaScript/NodeList|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) الموافق للقيمة المعطاة. لذا يجب أن تحذر من استخدام نفس القيمة كاسمٍ ومُعرّفٍ في نفس الوقت. | ||
| سطر 41: | سطر 40: | ||
* <code>[[JavaScript/Document/getElementById|Document.getElementById()]]</code> للحصول على مرجع للعنصر حسب مُعرّفه <code>id</code>. | * <code>[[JavaScript/Document/getElementById|Document.getElementById()]]</code> للحصول على مرجع للعنصر حسب مُعرّفه <code>id</code>. | ||
* <code>[[JavaScript/Document/getElementsByTagName|Document.getElementsByTagName()]]</code> للحصول على مراجع للعناصر حسب اسم الوسم المعطى. | * <code>[[JavaScript/Document/getElementsByTagName|Document.getElementsByTagName()]]</code> للحصول على مراجع للعناصر حسب اسم الوسم المعطى. | ||
* <code>[[JavaScript/Document/querySelector|Document.querySelector()]]</code> لاستعمال المُحدِّدات التي تستعمل استعلامات مثل <code> | * <code>[[JavaScript/Document/querySelector|Document.querySelector()]]</code> لاستعمال المُحدِّدات التي تستعمل استعلامات مثل <code>div.myclass</code>. | ||
==مصادر ومواصفات== | ==مصادر ومواصفات== | ||
* مواصفة [https://html.spec.whatwg.org/multipage/#dom-document-getelementsbyname HTML Living Standard] | * مواصفة [https://html.spec.whatwg.org/multipage/#dom-document-getelementsbyname HTML Living Standard]. | ||
* مواصفة [https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-71555259 Document Object Model (DOM) Level 2 HTML Specification] | * مواصفة [https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-71555259 Document Object Model (DOM) Level 2 HTML Specification]. | ||
[[تصنيف:JavaScript]] | [[تصنيف:JavaScript]] | ||
مراجعة 11:13، 31 مارس 2018
يُعيد التّابع 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.