Attribut HTML : minlength
L'attribut minlength
définit le nombre minimal de caractères (sous forme d'unités de code UTF-16) que l'utilisateur peut saisir dans un élément <input>
ou <textarea>
. Il doit s'agir d'une valeur entière égale ou supérieure à 0. Si aucune longueur minimale n'est spécifiée, ou si une valeur invalide est spécifiée, l'entrée n'a pas de longueur minimale. Cette valeur doit être inférieure ou égale à la valeur de maxlength
, sinon la valeur ne sera jamais valide, car il est impossible de satisfaire aux deux critères.
L'entrée échouera à la validation des contraintes si la longueur de la valeur textuelle du champ est inférieure à minlength
unités de code UTF-16, avec validityState.tooShort
retournant true
. La validation des contraintes n'est appliquée que lorsque la valeur est modifiée par l'utilisateur. En cas d'échec de la soumission, certains navigateurs affichent un message d'erreur indiquant la longueur minimale requise et la longueur actuelle.
Exemples
En ajoutant minlength="5"
, la valeur doit soit être vide, soit comporter cinq caractères ou plus pour être valide.
<label for="fruit">Entrez un nom de fruit d'au moins 5 lettres.</label>
<input type="text" minlength="5" id="fruit" />
Nous pouvons utiliser des pseudo-classes pour donner un style à l'élément en fonction de la validité de la valeur. La valeur sera valide tant qu'elle sera soit nulle (vide), soit longue de cinq caractères ou plus. Vert est invalide, Citron est valide.
input {
border: 2px solid currentcolor;
}
input:invalid {
border: 2px dashed red;
}
input:invalid:focus {
background-image: linear-gradient(pink, lightgreen);
}
Spécifications
Specification |
---|
HTML Standard # attr-input-minlength |
HTML Standard # attr-textarea-minlength |
Compatibilité des navigateurs
html.elements.input.minlength
BCD tables only load in the browser
html.elements.textarea.minlength
BCD tables only load in the browser
Voir aussi
- L'attribut
maxlength
- L'attribut
size
- L'attribut
pattern
- Validation des contraintes
- L'API Constraint validation
- L'élément
<input>