`Document.forms`

تُعيد الخاصّية 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.