Document.forms

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La propriété forms de Document retourne une collection (HTMLCollection) des éléments <form> présents dans le document actuel.

Note : De même, vous pouvez accéder à une liste des éléments d'entrée utilisateur d'un formulaire à l'aide de la propriété HTMLFormElement.elements.

Syntaxe

js
collection = document.forms;

Valeur

Un objet HTMLCollection listant tous les formulaires du document. Chaque élément de la collection est un HTMLFormElement représentant un seul élément <form>.

Exemples

Récupérer les informations d'un formulaire

html
<!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>

Accéder à un élément contenu dans un formulaire

js
var selectForm = document.forms[index];
var selectFormElement = document.forms[index].elements[index];

Accéder aux formulaires nommés

html
<!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; // Ou document.forms['login']
      loginForm.elements.email.placeholder = "test@example.com";
      loginForm.elements.password.placeholder = "password";
    </script>
  </body>
</html>

Spécifications

Specification
HTML Standard
# dom-document-forms-dev

Voir aussi