الفرق بين المراجعتين لصفحة: «JavaScript/Document/forms»
< JavaScript | Document
ط تنسيق الصّفحة |
طلا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>Document.forms</code>}}</noinclude> | <noinclude>{{DISPLAYTITLE:<code>Document.forms</code>}}</noinclude> | ||
تُعيد الخاصّية <code>forms</code> مجموعة من النّوع <code>HTMLCollection</code> تحتوي على جميع عناصِر [[HTML/ | تُعيد الخاصّية <code>forms</code> مجموعة من النّوع <code>[[JavaScript/HTMLCollection|HTMLCollection]]</code> تحتوي على جميع عناصِر <code>[[HTML/from|<form>]]</code> في المُستند. | ||
'''ملاحظة:''' يُمكنك كذلك استعمال الخاصيّة [[ | '''ملاحظة:''' يُمكنك كذلك استعمال الخاصيّة <code>[[HTMLFormElement/elements|HTMLFormElement.elements]]</code> للحصول على قائمةٍ بعناصِر نماذج الإدخال بشكلٍ مُشابه. | ||
==البنية العامة== | ==البنية العامة== | ||
| سطر 10: | سطر 10: | ||
===القيمة=== | ===القيمة=== | ||
كائنٌ من النّوع <code>HTMLCollection</code> يُمثّل قائمةً بجميع النّماذج في المُستند. كلّ عنصر من المجموعة يُعدّ من النّوع <code>HTMLFormElement</code> ويُمثّل عنصر <code>[[HTML/form|<form>]]</code> وحيد. | كائنٌ من النّوع <code>HTMLCollection</code> يُمثّل قائمةً بجميع النّماذج في المُستند. كلّ عنصر من المجموعة يُعدّ من النّوع <code>[[JavaScript/HTMLFormElement|HTMLFormElement]]</code> ويُمثّل عنصر <code>[[HTML/form|<form>]]</code> وحيد. | ||
إن لم يوجد أي نموذج في المُستند، فالمجموعة المُعادة ستكون فارغة بطولٍ يُساوي صفرًا. | إن لم يوجد أي نموذج في المُستند، فالمجموعة المُعادة ستكون فارغة بطولٍ يُساوي صفرًا. | ||
مراجعة 19:16، 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>