CKTIS / HTML
maxlength — maximale Textlänge
Das Attribut maxlength begrenzt die Textlänge in textarea und bestimmten input-Typen. Gezählt werden UTF-16-Codeeinheiten, nicht vom Menschen wahrgenommene Zeichen. Es begrenzt weder einen Zahlenwert noch kürzt es automatisch Text, der einem Skript zugewiesen wird.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
maxlength="N"maxlength="N" gibt die maximale Textlänge an. N muss eine nichtnegative ganze Zahl sein; 0 ist zulässig. Das Attribut gilt für textarea und die input-Typen text, search, tel, url, email und password. Für number gilt es nicht: max begrenzt einen Zahlenwert, nicht die Anzahl seiner Ziffern.
Die Länge wird in UTF-16-Codeeinheiten gemessen, nicht in vom Menschen wahrgenommenen Zeichen: Manche Emojis belegen zwei Einheiten. In textarea zählt jeder normalisierte Zeilenumbruch als eine Einheit.
Fehlt das Attribut, gibt es diese Begrenzung nicht. Ist auch minlength angegeben, darf dessen Wert maxlength nicht überschreiten. maxlength allein verlangt kein ausgefülltes Feld; dafür dient required.
Der Browser kann die Eingabe zu langen Textes verhindern. Der Zustand validity.tooLong setzt voraus, dass das Limit überschritten wurde, das Dirty-Value-Flag gesetzt ist und die letzte Änderung vom Benutzer vorgenommen wurde. Eine Skriptzuweisung an .value kürzt den Text nicht und setzt diesen Fehler nicht selbst, wie das Beispiel zeigt. Einschränkungen auf der Clientseite ersetzen keine serverseitige Validierung.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>maxlength</title>
<label for="tag">Tag (maximum 4 UTF-16 code units)</label>
<input id="tag" type="text" maxlength="4">
<pre id="result"></pre>
<script>
const tag = document.getElementById('tag');
tag.value = 'ABCDE';
document.getElementById('result').textContent =
`${tag.maxLength}\n${tag.value}\n${tag.validity.tooLong}`;
</script>
</html>Ergebnis
4 ABCDE false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.