WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

minlength — Mindestlänge des Textes

Das Attribut minlength legt die Mindestlänge eines nicht leeren, vom Nutzer eingegebenen Werts in einem textarea- oder unterstützten input-Feld fest. Es macht das Feld nicht verpflichtend; dafür dient required.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

minlength="N"

minlength="N" legt eine Mindestlänge für textarea und input mit dem Typ text, search, tel, url, email oder password fest. Für input mit dem Typ number gilt es nicht: min begrenzt den Zahlenwert, nicht die Textlänge.

N muss eine nichtnegative ganze Zahl sein. Wird auch maxlength angegeben, darf das Minimum das Maximum nicht überschreiten. Die Länge wird in UTF-16-Codeeinheiten gemessen, nicht in sichtbaren Zeichen. In textarea zählt ein normalisierter Zeilenumbruch als eine Einheit.

minlength ersetzt required nicht: Ein leerer Wert verletzt das Minimum nicht. Ein nicht leerer Wert, der nach einer Bearbeitung durch den Nutzer zu kurz ist, bewirkt validity.tooShort === true. Eine Zuweisung an value in JavaScript allein löst diesen Verstoß nicht aus und ist nicht mit dem Tippen gleichzusetzen.

Das Beispiel zeigt den Zustand mit validity.tooShort und checkValidity(). Gib abc ein, füge d hinzu und leere anschließend das Feld. Andere Einschränkungen, etwa die Gültigkeit einer Adresse bei type="email", gelten weiterhin unabhängig davon.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>minlength</title>
<label for="code">Code (min. 4)</label>
<input id="code" type="text" minlength="4">
<pre id="result">tooShort=false; valid=true</pre>
<script>
  const field = document.getElementById('code');
  const result = document.getElementById('result');
  field.addEventListener('input', () => {
    result.textContent = `tooShort=${field.validity.tooShort}; valid=${field.checkValidity()}`;
  });
</script>

Ergebnis

Initial: tooShort=false; valid=true
Type abc: tooShort=true; valid=false
Append d: tooShort=false; valid=true
Clear: tooShort=false; valid=true

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.

Quellen