Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Attribut HTML : min
L'attribut min définit la valeur minimale acceptable et valide pour le champ de saisie qui contient cet attribut. Si la valeur de l'élément est inférieure à cette valeur, le champ échoue lors de la validation. Cette valeur doit être inférieure ou égale à la valeur de l'attribut max.
Certains types de saisie ont une valeur minimale par défaut. Si le champ n'a pas de minimum par défaut et qu'une valeur spécifiée pour min ne peut pas être convertie en nombre valide (ou si aucune valeur minimale n'est définie), le champ n'a pas de valeur minimale.
Cet attribut est valable pour les types de saisie suivants : date, month, week, time, datetime-local, number et range ainsi que pour l'élément HTML <meter>.
Syntaxe
| Type de saisie | Syntaxe | Exemple |
|---|---|---|
| date | yyyy-mm-dd |
<input type="date" min="2019-12-25" step="1"> |
| month | yyyy-mm |
<input type="month" min="2019-12" step="12"> |
| week | yyyy-W## |
<input type="week" min="2019-W23" step=""> |
| time | hh:mm |
<input type="time" min="09:00" step="900"> |
| datetime-local | yyyy-mm-ddThh:mm |
<input type="datetime-local" min="2019-12-25T19:30"> |
| number | <number> |
<input type="number" min="0" step="5" max="100"> |
| range | <number> |
<input type="range" min="60" step="5" max="100"> |
Note :
Lorsque les données saisies par l'utilisateur ne respectent pas la valeur minimale définie, la valeur est considérée comme non valide dans la validation des contraintes et correspondra aux pseudo-classes :invalid et :out-of-range.
Voir la validation côté client et rangeUnderflow pour plus d'informations.
Pour l'élément <meter>, l'attribut min définit la limite numérique inférieure de la plage mesurée. Celle-ci doit être inférieure à la valeur minimale (attribut max), si elle est spécifiée. Dans les deux cas, si elle est omise, la valeur est égale à 1 par défaut.
Impact sur step
Les valeurs de min et step définissent ce que sont les valeurs valides, même si l'attribut step n'est pas inclus, car step a par défaut la valeur 0.
Nous ajoutons une grande bordure rouge autour des entrées invalides :
input:invalid {
border: solid red 3px;
}
Nous définissons ensuite une entrée avec une valeur minimale de 7,2, en omettant l'attribut « step », qui a la valeur 1 par défaut.
<input id="myNumber" name="myNumber" type="number" min="7.2" value="8" />
Comme step a pour valeur 1 par défaut, les valeurs valides comprennent 7,2, 8,2, 9,2, et ainsi de suite. La valeur 8 n'est pas valide. Comme nous avons inclus une valeur non valide, les navigateurs compatibles afficheront la valeur comme non valide.
S'il n'est pas explicitement inclus, step prend par défaut la valeur 1 pour number et range, et 1 type d'unité (seconde, semaine, mois, jour) pour les types d'entrée date/heure.
Accessibilité
Fournissez des instructions pour aider les utilisateurs à comprendre comment remplir le formulaire et utiliser les contrôles individuels du formulaire. Indiquez toute entrée obligatoire et facultative, les formats de données et toute autre information pertinente. Lorsque vous utilisez l'attribut min, assurez-vous que cette exigence minimale est comprise par l'utilisateur. Fournir des instructions à l'intérieur des <label> peut être suffisant. Si vous fournissez des instructions en dehors des étiquettes, ce qui permet un positionnement et une conception plus souples, envisagez d'utiliser aria-labelledby ou aria-describedby.
Spécifications
| Specification |
|---|
| HTML # attr-input-min |
| HTML # attr-meter-max |
Compatibilité des navigateurs
html.elements.input.min
Chargement...
html.elements.meter.min
Chargement...
Voir aussi
- L'attribut
step - L'attribut
max - Les autres attributs de mesure :
low,high,optimum - Validation des contraintes
- Validation de formulaire
- L'attribut JavaScript
validityState.rangeUnderflow - La pseudo-classe CSS
:out-of-range - L'élément HTML
<input> - Les valeurs de l'attribut type date, month, week, time, datetime-local, number et range
- L'élément HTML
<meter>