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. 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 sera vrai, et le contrôle sera assorti des pseudo-classes :out-of-range et :invalid.
Syntaxe
| Type de saisie | Syntaxe | Exemple |
|---|---|---|
date
|
html |
html |
month
|
html |
html |
week
|
html |
html |
time
|
html |
html |
datetime-local
|
yyyy-mm-ddThh:mm |
html |
number
|
<number> |
html |
range
|
<number> |
html |
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 et rangeOverflow 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
- L'attribut
step - L'attribut
min - Les autres attributs de mesure :
low,high,optimum - Validation des contraintes
- L'API Constraint validation
- L'attribut JavaScript
validityState.rangeOverflow :out-of-range- L'élément
<input> - Les valeurs de l'attribut type
date,month,week,time,datetime-local,numberetrange, et l'élement<meter>