HTMLInputElement: maxLength Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die maxLength-Eigenschaft der HTMLInputElement-Schnittstelle gibt die maximale Anzahl von Zeichen (in UTF-16-Code-Einheiten) an, die für den Wert des <input>-Elements eingegeben werden dürfen, sowie die maximale Anzahl von Zeichen, die für die Gültigkeit des Wertes erlaubt sind. Sie entspricht dem maxlength-Attribut des Elements. -1 bedeutet, dass es keine Begrenzung für die Länge des Wertes gibt.
Hinweis:
In der Regel verhindern Browser, dass Benutzer mehr Zeichen eingeben, als das maxlength-Attribut erlaubt. Sollte die Länge überschritten werden, wird das Element als ungültig betrachtet und die ValidityState-Objekt-Eigenschaft tooLong wird true sein.
Wert
Eine Zahl, die das maxlength 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 abzurufen 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 # dom-input-maxlength |