CKTIS / HTML
maxlength — longueur maximale du texte
L’attribut maxlength limite la longueur du texte dans textarea et certains types de input. Il compte les unités de code UTF-16, et non les caractères perçus par l’utilisateur. Il ne limite pas une valeur numérique et ne tronque pas automatiquement le texte attribué par un script.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
maxlength="N"maxlength="N" indique la longueur maximale du texte. N doit être un entier non négatif ; 0 est autorisé. L’attribut s’applique à textarea et aux types de input suivants : text, search, tel, url, email et password. Il ne s’applique pas à number : max limite une valeur numérique, pas le nombre de ses chiffres.
La longueur est mesurée en unités de code UTF-16, et non en caractères perçus par l’utilisateur : certains emoji occupent deux unités. Dans textarea, chaque saut de ligne normalisé compte comme une unité.
Si l’attribut est absent, cette limite ne s’applique pas. Si minlength est également indiqué, sa valeur ne doit pas dépasser maxlength. À lui seul, maxlength n’impose pas que le champ soit rempli ; utilisez required pour cela.
Le navigateur peut empêcher la saisie d’un texte trop long. L’état validity.tooLong nécessite que la limite soit dépassée, que l’indicateur de valeur modifiée soit activé et que la dernière modification ait été effectuée par l’utilisateur. L’affectation de .value par un script ne tronque pas le texte et ne déclenche pas à elle seule cette erreur, comme le montre l’exemple. Les contraintes côté client ne remplacent pas la validation côté serveur.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>maxlength</title>
<label for="tag">Tag (maximum 4 UTF-16 code units)</label>
<input id="tag" type="text" maxlength="4">
<pre id="result"></pre>
<script>
const tag = document.getElementById('tag');
tag.value = 'ABCDE';
document.getElementById('result').textContent =
`${tag.maxLength}\n${tag.value}\n${tag.validity.tooLong}`;
</script>
</html>Résultat
4 ABCDE false
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.