HTMLInputElement : 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 HTMLInputElement indique le nombre maximal de caractères (en unités de code UTF-16) autorisé pour la valeur de l'élément HTML <input>, 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 aucune limite sur la longueur de la valeur.
Note :
Les navigateurs empêchent généralement les utilisateur·ice·s de saisir plus de caractères que ce que permet l'attribut maxlength. Si la longueur est supérieure, l'élément est considéré comme invalide et la propriété tooLong de l'objet ValidityState sera à true.
Valeur
Un nombre représentant la valeur maxlength de l'élément si elle est présente, ou -1.
Exemple
Étant donné le HTML suivant :
<p>
<label for="password">Votre mot de passe</label>
<input id="password" type="password" minlength="8" maxlength="20" />
</p>
Vous pouvez utiliser la propriété maxLength pour lire ou modifier la valeur de l'attribut maxlength de l'élément <input> :
const inputElement = document.querySelector("#password");
console.log(`maxLength de l'élément : ${inputElement.maxLength}`); // "maxLength de l'élément : 20"
inputElement.maxLength = 18; // met à jour la valeur de l'attribut maxlength
Spécifications
| Specification |
|---|
| HTML # dom-input-maxlength |
Compatibilité des navigateurs
Voir aussi
- La propriété
HTMLInputElement.value - La propriété
HTMLInputElement.minLength - La propriété
ValidityState.tooLong