HTML-Attribut: min

Das min-Attribut definiert den minimal akzeptablen und gültigen Wert für die Eingabe, die das Attribut enthält. Wenn der value des Elements kleiner ist als dieser, schlägt die Validierung des Elements fehl. Dieser Wert muss kleiner oder gleich dem Wert des max-Attributs sein.

Einige Eingabetypen haben ein standardmäßiges Minimum. Wenn die Eingabe kein standardmäßiges Minimum hat und ein Wert für min angegeben wird, der nicht in eine gültige Zahl umgewandelt werden kann (oder kein Minimalwert festgelegt ist), hat die Eingabe keinen Minimalwert.

Es ist gültig für die Eingabetypen einschließlich: date, month, week, time, datetime-local, number und range Typen, und das <meter>-Element.

Syntax

Syntax für min Werte nach Eingabe type
Eingabetyp Syntax Beispiel
date yyyy-mm-dd <input type="date" min="2019-12-25" step="1">
month yyyy-mm <input type="month" min="2019-12" step="12">
week yyyy-W## <input type="week" min="2019-W23" step="">
time HH:mm <input type="time" min="09:00" step="900">
datetime-local yyyy-mm-ddTHH:mm <input type="datetime-local" min="2019-12-25T19:30">
number <number> <input type="number" min="0" step="5" max="100">
range <number> <input type="range" min="60" step="5" max="100">

Hinweis: Wenn die vom Benutzer eingegebenen Daten nicht dem festgelegten Minimalwert entsprechen, wird der Wert als ungültig in der Einschränkungsvalidierung betrachtet und passt zu den :invalid- und :out-of-range-Pseudoklassen.

Siehe Client-seitige Validierung und rangeUnderflow für weitere Informationen.

Für das <meter>-Element definiert das min-Attribut die untere numerische Grenze des gemessenen Bereichs. Diese muss kleiner sein als der maximale Wert (wenn das max-Attribut angegeben ist). In beiden Fällen, wenn nicht angegeben, beträgt der Standardwert 1.

Syntax für min Werte für andere Elemente
Eingabetyp Syntax Beispiel
<meter> <number> <meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="40"> bei 40/100</meter>

Auswirkungen auf step

Der Wert von min und step definiert, welche Werte gültig sind, selbst wenn das step-Attribut nicht enthalten ist, da step standardmäßig 0 ist.

Wir fügen einen großen roten Rahmen um ungültige Eingaben hinzu:

css
input:invalid {
  border: solid red 3px;
}

Dann definieren wir eine Eingabe mit einem minimalen Wert von 7.2, wobei das step-Attribut weggelassen wird, wo es standardmäßig 1 ist.

html
<input id="myNumber" name="myNumber" type="number" min="7.2" value="8" />

Da step standardmäßig 1 ist, sind gültige Werte 7.2, 8.2, 9.2 usw. Der Wert 8 ist nicht gültig. Da wir einen ungültigen Wert eingeschlossen haben, zeigen unterstützende Browser den Wert als ungültig an.

Wenn nicht explizit angegeben, beträgt der Standardwert von step 1 für number und range sowie 1 Einheitentyp (Sekunde, Woche, Monat, Tag) für die Datum/Zeit-Eingabetypen.

Barrierefreiheitsbedenken

Geben Sie Anweisungen an, um den Benutzern zu helfen, das Formular auszufüllen und die einzelnen Formularsteuerelemente zu nutzen. Geben Sie alle erforderlichen und optionalen Eingaben, Datenformate und andere relevante Informationen an. Beim Verwenden des min-Attributs stellen Sie sicher, dass diese Mindestanforderung vom Benutzer verstanden wird. Anweisungen innerhalb des <label> anzugeben, kann ausreichend sein. Wenn Sie Anweisungen außerhalb von Labels bereitstellen, was eine flexiblere Positionierung und Gestaltung ermöglicht, ziehen Sie in Betracht, aria-labelledby oder aria-describedby zu verwenden.

Spezifikationen

Specification
HTML Standard
# attr-input-min
HTML Standard
# attr-meter-max

Browser-Kompatibilität

html.elements.input.min

BCD tables only load in the browser

html.elements.meter.min

BCD tables only load in the browser

Siehe auch