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

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

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

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

Accéder aux formulaires nommés

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

Spécification Statut Commentaire
HTML Living Standard
La définition de 'Document.forms' dans cette spécification.
Standard évolutif  
Document Object Model (DOM) Level 2 HTML Specification
La définition de 'Document.forms' dans cette spécification.
Obsolete Définition initiale.

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : loella16, Watilin
Dernière mise à jour par : loella16,