HTML-Attribut: min
Das min-Attribut definiert den minimal akzeptablen und gültigen Wert für das Eingabefeld, das dieses Attribut enthält. Ist der value des Elements kleiner als dieser, schlägt das Element bei der Validierung fehl. Dieser Wert muss kleiner oder gleich dem Wert des max-Attributs sein.
Einige Eingabetypen haben einen Standard-Mindestwert. Wenn für die Eingabe kein Standard-Mindestwert vorhanden ist und ein Wert für min angegeben wird, der nicht in eine gültige Zahl umgewandelt werden kann (oder kein Mindestwert festgelegt ist), hat die Eingabe keinen Mindestwert.
Es ist gültig für die Eingabetypen einschließlich: date, month, week, time, datetime-local, number und range Typen 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 dem festgelegten Mindestwert entsprechen, wird der Wert bei der Einschränkungsvalidierung als ungültig betrachtet und entspricht den :invalid und :out-of-range Pseudoklassen.
Siehe Clientseitige 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 Maximalwert (max Attribut), falls angegeben. In beiden Fällen wird der Wert, wenn weggelassen, standardmäßig auf 1 gesetzt.
Auswirkungen auf Schrittweite
Der Wert von min und step definiert, was gültige Werte sind, auch 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, ohne das step-Attribut festzulegen, wobei es standardmäßig auf 1 gesetzt ist.
<input id="myNumber" name="myNumber" type="number" min="7.2" value="8" />
Da step standardmäßig auf 1 gesetzt 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 eingegeben haben, wird der Wert in unterstützenden Browsern als ungültig angezeigt.
Wenn nicht explizit angegeben, 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, die Benutzern helfen, das Formular auszufüllen, und nutzen Sie die einzelnen Formularelemente. Geben Sie alle erforderlichen und optionalen Eingaben, Datenformate und andere relevante Informationen an. Wenn Sie das min-Attribut verwenden, stellen Sie sicher, dass dieses Mindestanforderung vom Benutzer verstanden wird. Die Bereitstellung von Anweisungen innerhalb des <label> kann ausreichend sein. Wenn Sie Anweisungen außerhalb von Labels bereitstellen, die eine flexiblere Positionierung und Gestaltung ermöglichen, sollten Sie aria-labelledby oder aria-describedby in Betracht ziehen.
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 sowie das
<meter>