HTMLInputElement: maxLength-Eigenschaft
Die maxLength-Eigenschaft des HTMLInputElement-Interfaces gibt die maximale Anzahl von Zeichen (in UTF-16 Codeeinheiten) an, die für den Wert des <input>-Elements eingegeben werden dürfen, sowie die maximale Anzahl von Zeichen, die für den Wert gültig sind. Sie spiegelt das maxlength-Attribut des Elements wider. -1 bedeutet, dass es keine Begrenzung der Wertlänge gibt.
Hinweis:
Browser verhindern generell, dass Benutzer mehr Zeichen eingeben, als das maxlength-Attribut erlaubt. Sollte die Länge überschritten werden, wird das Element als ungültig angesehen und die tooLong-Eigenschaft des ValidityState-Objekts wird true sein.
Wert
Eine Zahl, die das maxlength-Attribut des Elements darstellt, falls vorhanden, oder -1.
Beispiel
Angenommen, folgendes HTML:
<p>
<label for="password">Your password</label>
<input id="password" type="password" minlength="8" maxlength="20" />
</p>
Sie können die maxLength-Eigenschaft verwenden, um den Wert des maxlength-Attributs des <input>-Elements zu erhalten oder festzulegen:
const inputElement = document.querySelector("#password");
console.log(`Element's maxLength: ${inputElement.maxLength}`); // "Element's maxlength: 20"
inputElement.maxLength = 18; // updates the element's maxlength attribute value
Spezifikationen
| Specification |
|---|
| HTML Standard # dom-input-maxlength |
Browser-Kompatibilität
BCD tables only load in the browser