Attribut HTML : maxlength
L'attribut maxlength définit la longueur maximale de chaîne de caractères que l'utilisateur·rice peut saisir dans un élément HTML <input> ou un élément <textarea>. L'attribut doit avoir une valeur entière supérieure ou égale à 0.
La longueur est mesurée en unités de code UTF-16, ce qui correspond souvent, mais pas toujours, au nombre de caractères. Si aucun maxlength n'est spécifié, ou si une valeur invalide est spécifiée, la saisie n'a pas de longueur maximale.
Toute valeur de maxlength doit être supérieure ou égale à la valeur de minlength, si elle est présente et valide. Le champ échouera à la validation des contraintes si la longueur du texte saisi dépasse le nombre d'unités de code UTF-16 autorisé par maxlength. La validation des contraintes n'est appliquée que lorsque la valeur est modifiée par l'utilisateur·rice.
Validation des contraintes
Bien que le navigateur empêche généralement l'utilisateur de saisir plus de texte que ne l'autorise l'attribut maxlength, si la longueur est supérieure à ce dernier, la propriété en lecture seule ValidityState.tooLong d'un objet ValidityState sera vraie.
Exemple interactif
<label for="name">Nom du produit :</label>
<input
id="name"
name="name"
type="text"
value="Shampoing"
minlength="3"
maxlength="20"
required />
<label for="description">Description du produit :</label>
<textarea
id="description"
name="description"
minlength="10"
maxlength="40"
required></textarea>
label {
display: block;
margin-top: 1em;
}
input:valid,
textarea:valid {
background-color: palegreen;
}
Exemple
<input type="password" maxlength="4" />
Spécifications
| Specification |
|---|
| HTML # attr-input-maxlength |
| HTML # attr-textarea-maxlength |
Compatibilité des navigateurs
html.elements.input.maxlength
Chargement…
html.elements.textarea.maxlength
Chargement…
Voir aussi
- L'attribut
minlength - L'attribut
size - L'attribut
pattern - Validation des contraintes
- Validation de formulaire
- L'élément HTML
<input>