blob: 9331ece5905c084098927db03ce809698577b42f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
---
title: Document.forms
slug: Web/API/Document/forms
tags:
- API
- DOM
- Document
- Formulaires
- Propriétés
translation_of: Web/API/Document/forms
---
{{APIRef("DOM")}}
La propriété `forms` de {{domxref("Document")}} retourne une collection ({{domxref("HTMLCollection")}}) des éléments {{HTMLElement("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é {{domxref ("HTMLFormElement.elements")}}.
## Syntaxe
collection = document.forms;
### Valeur
Un objet {{domxref("HTMLCollection")}} listant tous les formulaires du document. Chaque élément de la collection est un {{domxref("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
| Spécification | Statut | Commentaire |
| -------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------- |
| {{SpecName('HTML WHATWG', '#dom-document-forms', 'Document.forms')}} | {{ Spec2('HTML WHATWG') }} | |
| {{SpecName('DOM2 HTML', 'html.html#ID-1689064', 'Document.forms')}} | {{ Spec2('DOM2 Events') }} | Définition initiale. |
## Voir aussi
- [Formulaires HTML](/fr/docs/Web/Guide/HTML/Formulaires)
- {{HTMLElement("form")}} et l'interface {{domxref("HTMLFormElement")}}
|
