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 (en-US) 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

Spécification Statut
HTML Living Standard
La définition de 'l'attribut minlength' dans cette spécification.
Standard évolutif
HTML 5.1
La définition de 'l'attribut minlength' dans cette spécification.
Recommendation

Compatibilité des navigateurs

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

Voir aussi