CKTIS / HTML
minlength — longueur minimale du texte
L’attribut minlength définit la longueur minimale d’une valeur non vide saisie par l’utilisateur dans un textarea ou un champ input pris en charge. Il ne rend pas le champ obligatoire ; utilisez required pour cela.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
minlength="N"minlength="N" définit une longueur minimale pour textarea et pour input de type text, search, tel, url, email ou password. Il ne s’applique pas à input de type number : min limite la valeur numérique, pas la longueur du texte.
N doit être un entier non négatif. Si maxlength est également indiqué, le minimum ne doit pas dépasser le maximum. La longueur est mesurée en unités de code UTF-16, et non en caractères visibles. Dans un textarea, un saut de ligne normalisé compte comme une unité.
minlength ne remplace pas required : une valeur vide ne viole pas le minimum. Une valeur non vide trop courte après une modification par l’utilisateur entraîne validity.tooShort === true. Une simple affectation à value en JavaScript ne déclenche pas cette violation ; elle n’équivaut pas à une saisie.
L’exemple affiche l’état à l’aide de validity.tooShort et de checkValidity(). Saisissez abc, ajoutez d, puis effacez le champ. D’autres contraintes, comme la validité d’une adresse pour type="email", continuent de s’appliquer indépendamment.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>minlength</title>
<label for="code">Code (min. 4)</label>
<input id="code" type="text" minlength="4">
<pre id="result">tooShort=false; valid=true</pre>
<script>
const field = document.getElementById('code');
const result = document.getElementById('result');
field.addEventListener('input', () => {
result.textContent = `tooShort=${field.validity.tooShort}; valid=${field.checkValidity()}`;
});
</script>Résultat
Initial: tooShort=false; valid=true Type abc: tooShort=true; valid=false Append d: tooShort=false; valid=true Clear: tooShort=false; valid=true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.