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 als dieser Wert ist, schlägt die Validierung des Elements fehl. Dieser Wert muss kleiner oder gleich dem Wert des max Attributs sein.
Einige Eingabetypen haben einen standardmäßigen Minimalwert. Wenn die Eingabe keinen standardmäßigen Minimalwert aufweist 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: date, month, week, time, datetime-local, number und range, sowie das <meter> Element.
Syntax
| 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 den festgelegten Mindestwert einhalten, wird der Wert in der Restriktionsvalidierung als ungültig angesehen und entspricht den :invalid und :out-of-range Pseudoklassen.
Weitere Informationen finden Sie unter Client-seitige Validierung und rangeUnderflow.
Für das <meter> Element definiert das min Attribut die untere numerische Grenze des gemessenen Bereichs. Diese muss kleiner als der maximal zulässige Wert (max Attribut) sein, falls angegeben. In beiden Fällen, wenn sie weggelassen wird, beträgt der Standardwert 1.
Auswirkungen auf Schritt
Der Wert von min und step definiert, welche Werte gültig sind, selbst wenn das step Attribut nicht eingeschlossen ist, da step standardmäßig auf 0 gesetzt ist.
Wir fügen einen großen roten Rahmen um ungültige Eingaben hinzu:
input:invalid {
border: solid red 3px;
}
Definieren Sie dann eine Eingabe mit einem Mindestwert von 7.2, indem Sie das Schrittattribut weglassen, wobei es auf 1 standardmäßig gesetzt ist.
<input id="myNumber" name="myNumber" type="number" min="7.2" value="8" />
Da step standardmäßig 1 ist, sind die gültigen Werte 7.2, 8.2, 9.2 und so weiter. 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 ausdrücklich eingeschlossen, ist step standardmäßig 1 für number und range und 1 Einheitstyp (Sekunde, Woche, Monat, Tag) für die Datums-/Zeiteingabetypen.
Barrierefreiheitsbedenken
Geben Sie Anweisungen an, die Benutzern dabei helfen, das Formular zu vervollständigen und einzelne Formularelemente zu benutzen. Geben Sie an, welche Eingaben erforderlich und optional sind, welche Datenformate und andere relevante Informationen. Stellen Sie sicher, dass das minimale Erfordernis des min Attributs vom Benutzer verstanden wird. Die Bereitstellung von Anweisungen innerhalb des <label> kann ausreichend sein. Wenn Anweisungen außerhalb von Labels bereitgestellt werden, was eine flexiblere Positionierung und Gestaltung ermöglicht, erwägen Sie die Verwendung von aria-labelledby oder aria-describedby.
Spezifikationen
| Specification |
|---|
| HTML # attr-input-min |
| HTML # attr-meter-max |
Browser-Kompatibilität
html.elements.input.min
html.elements.meter.min
Siehe auch
stepmax- andere Meter-Attribute:
low,high,optimum - Einschränkungsvalidierung
- Formularvalidierung
validityState.rangeUnderflow:out-of-range<input>- date, month, week, time, datetime-local, number und range Typen, und das
<meter>