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
html
yyyy-mm-dd
html
<input type="date" max="2019-12-25" step="1">
month
html
yyyy-mm
html
<input type="month" max="2019-12" step="12">
week
html
yyyy-W##
html
<input type="week" max="2019-W23" step="">
time
html
hh:mm
html
<input type="time" max="17:00" step="900">
datetime-local yyyy-mm-ddThh:mm
html
<input type="datetime-local" max="2019-12-25T23:59">
number <number>
html
<input type="number" min="0" step="5" max="100">
range <number>
html
<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 (min attribut), si elle est spécifiée. Dans les deux cas, si elle est omise, la valeur est égale à 1 par défaut.

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

Specification
HTML Standard
# attr-input-max
HTML Standard
# attr-meter-max
HTML Standard
# attr-progress-max

Compatibilité des navigateurs

html.elements.input.max

BCD tables only load in the browser

html.elements.meter.max

BCD tables only load in the browser

html.elements.progress.max

BCD tables only load in the browser

Voir aussi