HTML-Attribut: min
Das min-Attribut definiert den minimal akzeptablen und gültigen Wert für das Eingabefeld, das dieses 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 kein standardmäßiger Minimalwert vorhanden ist und für min ein Wert angegeben wird, 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 Eingabetypen einschließlich: date, month, week, time, datetime-local, number und range Typen sowie für 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 von der Benutzerin oder dem Benutzer eingegebenen Daten nicht dem festgelegten min-Wert entsprechen, wird der Wert bei einer Einschränkungsvalidierung als ungültig betrachtet und wird die :invalid und :out-of-range Pseudo-Klassen erfüllen.
Weitere Informationen finden Sie unter Frontend-Validierung und rangeUnderflow.
Für das <meter>-Element definiert das min-Attribut die untere numerische Grenze des gemessenen Bereichs. Diese muss kleiner als der maximale Wert (max Attribut) sein, falls angegeben. In beiden Fällen, falls weggelassen, wird der Wert standardmäßig auf 1 gesetzt.
Auswirkung auf step
Der Wert von min und step definiert, welche Werte gültig sind, auch wenn das step-Attribut nicht einbezogen wird, da step standardmäßig auf 1 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, wobei das step-Attribut weggelassen wird, in welchem Fall es standardmäßig auf 1 gesetzt wird.
<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 und so weiter. Der Wert 8 ist nicht gültig. Da wir einen ungültigen Wert aufgenommen haben, zeigen unterstützende Browser den Wert als ungültig an.
Wenn nicht explizit eingeschlossen, ist step standardmäßig 1 für number und range, und 1 Einheitstyp (Sekunde, Woche, Monat, Tag) für die Datums-/Uhrzeit-Eingabetypen.
Barrierefreiheit
Geben Sie Anweisungen, um Benutzerinnen und Benutzern zu helfen, das Formular auszufüllen und einzelne Formularsteuerungen zu verwenden. Geben Sie erforderliche und optionale Eingaben, Datenformate und andere relevante Informationen an. Wenn Sie das min-Attribut verwenden, stellen Sie sicher, dass die Benutzerin oder der Benutzer diese Mindestanforderung versteht. Anweisungen innerhalb des <label> können ausreichend sein. Wenn Sie Anweisungen außerhalb von Labels bereitstellen, was eine flexiblere Positionierung und Gestaltung ermöglicht, sollten Sie aria-labelledby oder aria-describedby 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
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 sowie das
<meter>