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
|
---
title: 'Attribut HTML : required'
slug: Web/HTML/Attributes/required
tags:
- Attribute
- Attributes
- Constraint validation
- Forms
- required
translation_of: Web/HTML/Attributes/required
---
{{HTMLSidebar}}
L'attribut booléen **`required`**, s'il est présent, indique que l'utilisateur doit spécifier une valeur pour l'entrée avant que le formulaire propriétaire puisse être soumis. L'attribut `required` est pris en charge pour les éléments [`text`](/fr/docs/Web/HTML/Element/Input/text), [`search`](/fr/docs/Web/HTML/Element/Input/search), [`url`](/fr/docs/Web/HTML/Element/Input/url), [`tel`](/fr/docs/Web/HTML/Element/Input/tel), [`email`](/fr/docs/Web/HTML/Element/Input/email), [`password`](/fr/docs/Web/HTML/Element/Input/password), [`date`](/fr/docs/Web/HTML/Element/Input/date), [`month`](< /fr/docs/Web/HTML/Element/Input/month>), [`week`](/fr/docs/Web/HTML/Element/Input/week), [`time`](/fr/docs/Web/HTML/Element/Input/time), [`datetime-local`](/fr/docs/Web/HTML/Element/Input/datetime-local), [`number`](/fr/docs/Web/HTML/Element/Input/number), [`checkbox`](/fr/docs/Web/HTML/Element/Input/checkbox), [`radio`](/fr/docs/Web/HTML/Element/Input/radio), les éléments [`file`](/fr/docs/Web/HTML/Element/Input/file), [`<input>`](/fr/docs/Web/HTML/Element/Input), [`<select>`](/fr/docs/Web/HTML/Element/select) et [`<textarea>`](/fr/docs/Web/HTML/Element/Textarea) de contrôle de formulaire. Si elle est présente sur l'un de ces types de saisie et éléments, la pseudo-classe [`:required`](/fr/docs/Web/CSS/:required) s'appliquera. Si l'attribut n'est pas inclus, la pseudo-classe [`:optional`](/fr/docs/Web/CSS/:optional) s'appliquera.
L'attribut n'est pas pris en charge ou n'est pas pertinent pour [`range`](/fr/docs/Web/HTML/Element/Input/range) et [`color`](/fr/docs/Web/HTML/Element/Input/color), car les deux ont des valeurs par défaut. Il n'est pas non plus pris en charge sur [`hidden`](/fr/docs/Web/HTML/Element/Input/hidden) car on ne peut pas s'attendre à ce qu'un utilisateur remplisse un formulaire qui est caché. Il n'est pas non plus supporté sur aucun des types de boutons, y compris `image`.
Notez que `color` et `range` ne supportent pas `required`, mais le type `color` est par défaut `#000000`, et `range` prend par défaut le point médian entre `min` et `max` — avec `min` et `max` prenant par défaut les valeurs 0 et 100 respectivement dans la plupart des navigateurs s'ils ne sont pas déclarés — donc a toujours une valeur.
Dans le cas d'un groupe de boutons [`radio`](/fr/docs/Web/HTML/Element/Input/radio) de même nom, si un seul bouton radio dans le groupe a l'attribut `required`, un bouton radio dans ce groupe doit être vérifié, bien que ce ne soit pas nécessairement celui où l'attribut est appliqué. Ainsi, pour améliorer la maintenance du code, il est recommandé d'inclure l'attribut `required` dans chaque bouton radio de même nom dans le groupe, ou bien dans aucun.
Dans le cas d'un même groupe nommé de types d'entrée [`checkbox`](/fr/docs/Web/HTML/Element/Input/checkbox), seules les cases à cocher avec l'attribut `required` sont obligatoires.
> **Note :**Le réglage `aria-required="true"` indique à un lecteur d'écran qu'un élément (n'importe lequel) est requis, mais n'a aucune incidence sur le caractère facultatif de l'élément.
## Interactions entre attributs
Comme un champ en lecture seule ne peut pas avoir de valeur, `required` n'a aucun effet sur les entrées dont l'attribut [`readonly`](readonly) est également spécifié.
## Utilisabilité
Lorsque vous incluez l'attribut `required`, fournissez une indication visible à proximité du contrôle informant l'utilisateur que les éléments [`<input>`](/fr/docs/Web/HTML/Element/Input), [`<select>`](/fr/docs/Web/HTML/Element/select) ou [`<textarea>`](/fr/docs/Web/HTML/Element/Textarea) sont obligatoires. En outre, ciblez les contrôles de formulaire requis avec la pseudo-classe [`:required`](/fr/docs/Web/CSS/:required), en les stylisant de manière à indiquer qu'ils sont requis. Cela améliore la convivialité pour les utilisateurs voyants. Les technologies d'assistance doivent informer l'utilisateur que le contrôle de formulaire est obligatoire sur la base de l'attribut required, mais l'ajout de `aria-required="true"` ne fait pas de mal, au cas où la combinaison navigateur / lecteur d'écran ne prendrait pas encore en charge `required`.
## Validation des contraintes
Si l'élément est requis et que la valeur de l'élément est la chaîne vide, alors l'élément souffre de [`valueMissing`](/fr/docs/Web/API/ValidityState/valueMissing) et l'élément correspondra à la pseudo classe [`:invalid`](/fr/docs/Web/CSS/:invalid).
## Exemple
### HTML
```html
<form>
<div class="group">
<input type="text">
<label>Normal</label>
</div>
<div class="group">
<input type="text" required="required">
<label>Requis</label>
</div>
<input type="submit">
</form>
```
### Résultat
{{EmbedLiveSample('examples')}}
## Accessibilité
Fournissez une indication aux utilisateurs pour les informer que le contrôle de formulaire est requis. Veillez à ce que le message soit multiforme (texte, couleur, marquage, attribut, etc.) afin que tous les utilisateurs comprennent les exigences, qu'ils soient daltoniens, qu'ils présentent des différences cognitives ou qu'ils utilisent un lecteur d'écran.
## Spécifications
| Spécification | Statut |
| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| {{SpecName('HTML WHATWG', 'forms.html#attr-input-required', 'l\'attribut required')}} | {{Spec2('HTML WHATWG')}} |
| {{SpecName('HTML5 W3C', 'forms.html#attr-input-required', 'l\'attribut required')}} | {{Spec2('HTML5 W3C')}} |
| {{SpecName('HTML5.1', 'sec-forms.html#the-required-attribute', 'l\'attribut required')}} | {{Spec2('HTML5.1')}} |
## Compatibilité des navigateurs
{{Compat("html.elements.attributes.required")}}
## Voir aussi
- La propriété [`validityState.valueMissing`](/fr/docs/Web/API/validityState/valueMissing)
- Les pseudo-classes [`:required`](/fr/docs/Web/CSS/:required) et [`:optional`](/fr/docs/Web/CSS/:optional)
- L'élément [`<input>`](/fr/docs/Web/HTML/Element/Input)
- L'élément [`<select>`](/fr/docs/Web/HTML/Element/select)
|
