Attribut HTML : max

L'attribut max définit la valeur maximale acceptable et valide pour le champ de saisie contenant l'attribut. Si la valeur de l'élément est supérieure à cette valeur, l'élément échoue à la validation des contraintes (en-US). Cette valeur doit être supérieure ou égale à la valeur de l'attribut min. Si l'attribut max est présent mais n'est pas spécifié ou est invalide, aucune valeur max n'est appliquée. Si l'attribut max est valide et qu'une valeur non vide est supérieure au maximum autorisé par l'attribut max, la validation des contraintes empêchera la soumission du formulaire.

Valable pour les types de saisie numérique, y compris les date, month, week, time, datetime-local, number et range, ainsi que les deux éléments <progress> et <meter>, l'attribut max est un nombre qui spécifie la valeur la plus positive qu'un contrôle de formulaire doit considérer comme valide.

Si la valeur dépasse la valeur maximale autorisée, l'attribut JavaScript validityState.rangeOverflow (en-US) sera vrai, et le contrôle sera assorti des pseudo-classes :out-of-range et :invalid.

Syntaxe

Syntaxe pour les valeurs max par type de saisie.
Type de saisie Syntaxe Exemple
date yyyy-mm-dd <input type="date" max="2019-12-25" step="1">
month yyyy-mm <input type="month" max="2019-12" step="12">
week yyyy-W## <input type="week" max="2019-W23" step="">
time hh:mm <input type="time" max="17:00" step="900">
datetime-local yyyy-mm-ddThh:mm <input type="datetime-local" max="2019-12-25T23:59">
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 maximale fixée, la valeur est considérée comme invalide dans la validation des contraintes et correspondra aux pseudo-classes :invalid et :out-of-range.

Voir la validation côté client (en-US) et rangeOverflow (en-US) pour plus d'informations.

Pour l'élément <progress>, l'attribut max décrit la quantité de travail que nécessite la tâche indiquée par l'élément progress. S'il est présent, il doit avoir une valeur supérieure à zéro et être un nombre à virgule flottante valide. Pour l'élément <meter>, l'attribut max définit la limite numérique supérieure de la plage mesurée. Celle-ci doit être supérieure à la valeur minimale (code>min attribut), si elle est spécifiée. Dans les deux cas, si elle est omise, la valeur est égale à 1 par défaut.

Syntaxe des valeurs max pour les autres éléments
Type d'entrée Syntaxe Exemple
<progress> <number> <progress id="file" max="100" value="70"> 70% </progress>
<meter> <number> <meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="40"> à 40/100</meter>

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 max, assurez-vous que cette exigence maximale est comprise par l'utilisateur. Fournir des instructions dans le <label> peut être suffisant. Si vous fournissez des instructions en dehors des étiquettes, ce qui permet un positionnement et une conception plus flexibles, envisagez d'utiliser aria-labelledby ou aria-describedby.

Spécifications

Spécification Statut
HTML Living Standard
La définition de 'max attribute' dans cette spécification.
Standard évolutif
HTML5
La définition de 'max attribute' dans cette spécification.
Recommendation
HTML Living Standard
La définition de 'progress element' dans cette spécification.
Standard évolutif
HTML5
La définition de 'progress element' dans cette spécification.
Recommendation
HTML Living Standard
La définition de 'meter element' dans cette spécification.
Standard évolutif
HTML5
La définition de 'meter element' dans cette spécification.
Recommendation

Compatibilité des navigateurs

No compatibility data found for html.elements.attributes.max.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.

Voir aussi