Document.forms
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
- Formulaires HTML
<form>
et l'interfaceHTMLFormElement