HTMLTextAreaElement : propriété maxLength
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La propriété maxLength de l'interface HTMLTextAreaElement indique le nombre maximal de caractères (en unités de code UTF-16) autorisé pour la valeur de l'élément HTML <textarea>, ainsi que le nombre maximal de caractères autorisé pour que la valeur soit valide. Elle reflète l'attribut maxlength de l'élément. -1 signifie qu'il n'y a pas de limite à la longueur de la valeur.
Note :
Les navigateurs empêchent généralement les utilisateur·ice·s d'entrer plus de caractères que l'attribut maxlength autorise. Si la longueur est supérieure, l'élément est considéré comme non valide et la propriété tooLong de l'objet ValidityState sera true.
Valeur
Un nombre représentant la valeur de l'attribut maxlength de l'élément si présent, ou -1.
Exemples
Pour le HTML suivant :
<p>
<label for="comment">Commentaire</label>
<textarea id="comment" minlength="10" maxlength="200"></textarea>
</p>
Vous pouvez utiliser la propriété maxLength pour lire ou définir la valeur de l'attribut maxlength du <textarea> :
const textareaElement = document.querySelector("#comment");
console.log(`Valeur maxLength de l'élément : ${textareaElement.maxLength}`); // "Valeur maxLength de l'élément : 200"
textareaElement.maxLength = 220; // met à jour la valeur de l'attribut maxlength de l'élément
Spécifications
| Specification |
|---|
| HTML # dom-textarea-maxlength |
Compatibilité des navigateurs
Voir aussi
- La propriété
HTMLTextAreaElement.value - La propriété
HTMLTextAreaElement.minLength - La propriété
ValidityState.tooLong