Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources