الفرق بين المراجعتين لصفحة: «JavaScript/Document/forms»

المراجعة الحالية بتاريخ 14:29، 7 أكتوبر 2022

تُعيد الخاصّية forms مجموعة من النّوع HTMLCollection تحتوي على جميع عناصِر <form> في المُستند.

ملاحظة: يُمكنك كذلك استعمال الخاصيّة HTMLFormElement.elements للحصول على قائمةٍ بعناصِر نماذج الإدخال بشكلٍ مُشابه.

البنية العامة

collection = document.forms;

القيمة

كائنٌ من النّوع HTMLCollection يُمثّل قائمةً بجميع النّماذج في المُستند. كلّ عنصر من المجموعة يُعدّ من النّوع HTMLFormElement ويُمثّل عنصر <form> وحيد.

إن لم يوجد أي نموذج في المُستند، فالمجموعة المُعادة ستكون فارغة بطولٍ يُساوي صفرًا.

أمثلة

الحصول على معلومات نموذج مُعيّن:

<!DOCTYPE html>
<html lang="en">
  <head>
    <title>document.forms</title>
  </head>
  <body>
    <form id="ahmed">
      <input type="button" onclick="alert(document.forms[0].id);" value="ahmed's form">
    </form>

    <form id="osama">
      <input type="button" onclick="alert(document.forms[1].id);" value="osama's form">
    </form>

    <form id="raghad">
      <input type="button" onclick="alert(document.forms[2].id);" value="raghad'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</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; // أو document.forms['login']
      loginForm.elements.email.placeholder = 'test@example.com';
      loginForm.elements.password.placeholder = 'password';
    </script>
  </body>
</html>

انظر أيضًا

نماذج HTML.
العنصر <form>.

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

مواصفة HTML Living Standard.
مواصفة Document Object Model (DOM) Level 2 HTML Specification.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:<code>Document.forms</code>}}</noinclude>
-تُعيد الخاصّية <code>forms</code> مجموعة من النّوع  <code>[[JavaScript/HTMLCollection|HTMLCollection]]</code> تحتوي على جميع عناصِر <code>[[HTML/from|<form>]]</code> في المُستند.
+تُعيد الخاصّية <code>forms</code> مجموعة من النّوع  <code>[[JavaScript/HTMLCollection|HTMLCollection]]</code> تحتوي على جميع عناصِر <code>[[HTML/form|<form>]]</code> في المُستند.
 '''ملاحظة:''' يُمكنك كذلك استعمال الخاصيّة <code>[[HTMLFormElement/elements|HTMLFormElement.elements]]</code> للحصول على قائمةٍ بعناصِر نماذج الإدخال بشكلٍ مُشابه.