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:

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:

js
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

Siehe auch