HTML-Attribut: minlength

Das minlength-Attribut definiert die minimale Zeichenfolgenlänge, die der Benutzer in ein <input> oder <textarea> eingeben kann. Das Attribut muss einen ganzzahligen Wert von 0 oder höher haben.

Die Länge wird in UTF-16 Code-Einheiten gemessen, was oft, aber nicht immer der Anzahl der Zeichen entspricht. Wenn kein minlength angegeben ist oder ein ungültiger Wert angegeben wird, hat die Eingabe keine Mindestlänge. Dieser Wert muss kleiner oder gleich dem Wert von maxlength sein, da es sonst unmöglich ist, beide Kriterien zu erfüllen.

Die Eingabe wird die Einschränkungsvalidierung nicht bestehen, wenn die Länge des Textwertes des Feldes weniger als die Anzahl der UTF-16 Code-Einheiten ist, die durch minlength festgelegt wurden, wobei validityState.tooShort true zurückgibt. Die Einschränkungsvalidierung wird nur angewendet, wenn der Wert vom Benutzer geändert wird. Sobald die Übermittlung fehlschlägt, werden einige Browser eine Fehlermeldung anzeigen, die die erforderliche Mindestlänge und die aktuelle Länge angibt.

minlength impliziert nicht required; eine Eingabe verletzt nur eine minlength-Einschränkung, wenn der Benutzer einen Wert eingegeben hat. Wenn eine Eingabe nicht required ist, kann ein leerer String eingereicht werden, auch wenn minlength gesetzt ist.

Probieren Sie es aus

<label for="name">Product name:</label>
<input
  id="name"
  name="name"
  type="text"
  value="Shampoo"
  minlength="3"
  maxlength="20"
  required />

<label for="description">Product description:</label>
<textarea
  id="description"
  name="description"
  minlength="10"
  maxlength="40"
  required></textarea>
label {
  display: block;
  margin-top: 1em;
}

input:valid,
textarea:valid {
  background-color: palegreen;
}

Beispiele

Durch das Hinzufügen von minlength="5" muss der Wert entweder leer sein oder fünf oder mehr Zeichen lang sein, um gültig zu sein.

html
<label for="fruit">Enter a fruit name that is at least 5 letters long</label>
<input type="text" minlength="5" id="fruit" />

Wir können Pseudoklassen verwenden, um das Element basierend darauf zu stylen, ob der Wert gültig ist. Der Wert ist gültig, solange er entweder null (leer) ist oder fünf oder mehr Zeichen lang ist. Lime ist ungültig, lemon ist gültig.

css
input {
  border: 2px solid currentcolor;
}
input:invalid {
  border: 2px dashed red;
}
input:invalid:focus {
  background-image: linear-gradient(pink, lightgreen);
}

Spezifikationen

Specification
HTML
# attr-input-minlength
HTML
# attr-textarea-minlength

Browser-Kompatibilität

html.elements.input.minlength

html.elements.textarea.minlength

Siehe auch