الفرق بين المراجعتين لصفحة: «JavaScript/Document/forms»
< JavaScript | Document
إضافة الصّفحة |
ط تنسيق الصّفحة |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>Document.forms</code>}}</noinclude> | <noinclude>{{DISPLAYTITLE:<code>Document.forms</code>}}</noinclude> | ||
تُعيد الخاصّية <code>forms</code> مجموعة من النّوع HTMLCollection تحتوي على جميع عناصِر <form> في المُستند. | تُعيد الخاصّية <code>forms</code> مجموعة من النّوع <code>HTMLCollection</code> تحتوي على جميع عناصِر [[HTML/form|<code><form></code>]] في المُستند. | ||
ملاحظة: يُمكنك كذلك استعمال الخاصيّة[[JavaScript/HTMLFormElement/elements|HTMLFormElement.elements]] للحصول على قائمةٍ بعناصِر نماذج الإدخال بشكلٍ مُشابه. | |||
'''ملاحظة:''' يُمكنك كذلك استعمال الخاصيّة [[JavaScript/HTMLFormElement/elements|<code>HTMLFormElement.elements</code>]] للحصول على قائمةٍ بعناصِر نماذج الإدخال بشكلٍ مُشابه. | |||
==البنية العامة== | ==البنية العامة== | ||
| سطر 9: | سطر 10: | ||
===القيمة=== | ===القيمة=== | ||
كائنٌ من النّوع HTMLCollection يُمثّل قائمةً بجميع النّماذج في المُستند. كلّ عنصر من المجموعة يُعدّ من النّوع HTMLFormElement ويُمثّل عنصر <form> وحيد. | كائنٌ من النّوع <code>HTMLCollection</code> يُمثّل قائمةً بجميع النّماذج في المُستند. كلّ عنصر من المجموعة يُعدّ من النّوع <code>HTMLFormElement</code> ويُمثّل عنصر <code>[[HTML/form|<form>]]</code> وحيد. | ||
إن لم يوجد أي نموذج في المُستند، فالمجموعة المُعادة ستكون فارغة بطولٍ يُساوي صفرًا. | إن لم يوجد أي نموذج في المُستند، فالمجموعة المُعادة ستكون فارغة بطولٍ يُساوي صفرًا. | ||
| سطر 71: | سطر 72: | ||
==انظر أيضا== | ==انظر أيضا== | ||
* نماذج HTML | * [[HTML#.D8.A7.D9.84.D9.86.D9.85.D8.A7.D8.B0.D8.AC|نماذج HTML]] | ||
* العنصر form | * [[HTML/form|العنصر form]] | ||
==مصادر ومواصفات== | ==مصادر ومواصفات== | ||
* مواصفة [https://html.spec.whatwg.org/multipage/#dom-document-forms HTML Living Standard]. | * مواصفة [https://html.spec.whatwg.org/multipage/#dom-document-forms HTML Living Standard]. | ||
مراجعة 19:11، 20 مارس 2018
تُعيد الخاصّية forms مجموعة من النّوع HTMLCollection تحتوي على جميع عناصِر <form> في المُستند.
ملاحظة: يُمكنك كذلك استعمال الخاصيّة HTMLFormElement.elements للحصول على قائمةٍ بعناصِر نماذج الإدخال بشكلٍ مُشابه.
البنية العامة
collection = document.forms;
القيمة
كائنٌ من النّوع HTMLCollection يُمثّل قائمةً بجميع النّماذج في المُستند. كلّ عنصر من المجموعة يُعدّ من النّوع HTMLFormElement ويُمثّل عنصر <form> وحيد.
إن لم يوجد أي نموذج في المُستند، فالمجموعة المُعادة ستكون فارغة بطولٍ يُساوي صفرًا.
أمثلة
الحصول على معلومات نموذج مُعيّن:
<!DOCTYPE html>
<html lang="en">
<head>
<title>document.forms example</title>
</head>
<body>
<form id="robby">
<input type="button" onclick="alert(document.forms[0].id);" value="robby's form" />
</form>
<form id="dave">
<input type="button" onclick="alert(document.forms[1].id);" value="dave's form" />
</form>
<form id="paul">
<input type="button" onclick="alert(document.forms[2].id);" value="paul's form" />
</form>
</body>
</html>
الحصول على عنصرٍ داخل النّموذج:
var selectForm = document.forms[index];
var selectFormElement = document.forms[index].elements[index];
الوصول إلى النماذج عبر أسمائها:
<!DOCTYPE html>
<html lang="en">
<head>
<title>document.forms example</title>
</head>
<body>
<form name="login">
<input name="email" type="email">
<input name="password" type="password">
<button type="submit">Log in</button>
</form>
<script>
var loginForm = document.forms.login; // Or document.forms['login']
loginForm.elements.email.placeholder = 'test@example.com';
loginForm.elements.password.placeholder = 'password';
</script>
</body>
</html>