`Document.forms`

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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