min HTML-Attribut
Das min Attribut definiert den minimal akzeptablen und gültigen Wert für die Eingabe, die dieses Attribut enthält. Wenn der value des Elements kleiner ist als dieser Wert, schlägt das Element bei der Validierung fehl. Dieser Wert muss kleiner oder gleich dem Wert des max Attributs sein.
Einige Eingabetypen haben ein Standardminimum. Wenn die Eingabe kein Standardminimum hat und ein Wert für min angegeben ist, der nicht in eine gültige Zahl konvertiert werden kann (oder kein Mindestwert festgelegt ist), hat die Eingabe keinen Mindestwert.
Es ist gültig für die Eingabetypen, die date, month, week, time, datetime-local, number und range Typen und das <meter> Element einschließen.
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 Min-Wert einhalten, wird der Wert bei der Einschränkungsvalidierung als ungültig betrachtet 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 sein als der maximale Wert (das max Attribut), falls angegeben. In beiden Fällen, falls weggelassen, beträgt der Standardwert 1.
Auswirkung 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 Rand um ungültige Eingaben hinzu:
input:invalid {
border: solid red 3px;
}
Dann definieren wir eine Eingabe mit einem Mindestwert von 7.2, wobei das step Attribut weggelassen wird, wobei es standardmäßig 1 ist.
<input id="myNumber" name="myNumber" type="number" min="7.2" value="8" />
Da step standardmäßig 1 ist, umfassen 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 inkludiert, beträgt step standardmäßig 1 für number und range, und 1 Einheitentyp (Sekunde, Woche, Monat, Tag) für die Datums-/Uhrzeit-Eingabetypen.
Barrierefreiheitsbedenken
Geben Sie Anweisungen, um den Benutzern zu helfen zu verstehen, wie sie das Formular ausfüllen und einzelne Formularelemente verwenden sollen. Geben Sie etwaige erforderliche und optionale Eingaben, Datenformate und andere relevante Informationen an. Wenn Sie das min Attribut verwenden, stellen Sie sicher, dass diese Mindestanforderung vom Benutzer verstanden wird. Anweisungen innerhalb des <label> bereitzustellen, kann ausreichend sein. Falls Anweisungen außerhalb von Labels bereitgestellt werden, was eine flexiblere Positionierung und Gestaltung erlaubt, ziehen Sie die Verwendung von aria-labelledby oder aria-describedby in Betracht.
Spezifikationen
| Spezifikation |
|---|
| HTML # attr-input-min |
| HTML # attr-meter-max |
Browser-Kompatibilität
html.elements.input.min
html.elements.meter.min
Siehe auch
stepmax- weitere 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>