Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

minlength HTML-Attribut

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 Codeeinheiten gemessen, was oft, aber nicht immer der Anzahl der Zeichen entspricht. Wenn kein minlength festgelegt 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 schlägt bei der Einschränkungsvalidierung fehl, wenn die Länge des Textwerts des Feldes kürzer als minlength in UTF-16 Codeeinheiten ist, wobei validityState.tooShort true zurückgibt. Die Einschränkungsvalidierung wird nur angewendet, wenn der Wert vom Benutzer geändert wird. Wenn die Übermittlung fehlschlägt, zeigen einige Browser eine Fehlermeldung an, 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 übermittelt 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 Hinzufügen von minlength="5" muss der Wert entweder leer oder mindestens fünf 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) 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

Spezifikation
HTML
# attr-input-minlength
HTML
# attr-textarea-minlength

Browser-Kompatibilität

html.elements.input.minlength

html.elements.textarea.minlength

Siehe auch