HTML-Attribut: min
Das min-Attribut definiert den minimalen Wert, der für die Eingabe mit diesem Attribut akzeptabel und gültig ist. Wenn der value des Elements kleiner ist als dieser Wert, schlägt die Validierung des Elements fehl. Dieser Wert muss kleiner oder gleich dem Wert des max-Attributs sein.
Einige Eingabetypen haben einen Standard-Mindestwert. Wenn die Eingabe keinen Standard-Mindestwert hat und für min ein Wert festgelegt wird, der nicht in eine gültige Zahl umgewandelt werden kann (oder kein Mindestwert festgelegt wird), 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, und 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 dem Benutzer eingegebenen Daten nicht dem festgelegten Mindestwert entsprechen, wird der Wert in der Einschränkungsvalidierung als ungültig betrachtet und entspricht den :invalid und :out-of-range Pseudoklassen.
Siehe Client-seitige Validierung und rangeUnderflow für mehr 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 (max-Attribut), falls festgelegt. In beiden Fällen, wenn weggelassen, ist der Standardwert 1.
Auswirkungen auf Schritt
Der Wert von min und step definiert, welche Werte gültig sind, auch 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:
input:invalid {
border: solid red 3px;
}
Dann definieren wir eine Eingabe mit einem Mindestwert von 7.2 und lassen das Step-Attribut weg, wobei 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 angegeben haben, werden unterstützende Browser den Wert als ungültig anzeigen.
Wenn nicht explizit angegeben, ist step standardmäßig 1 für number und range, und 1 Einheitstyp (Sekunde, Woche, Monat, Tag) für die Datum/Zeit-Eingabetypen.
Barrierefreiheit
Geben Sie Anweisungen, um Benutzern zu helfen, das Formular auszufüllen und die einzelnen Formularelemente zu verwenden. Geben Sie an, welche Eingaben erforderlich und optional sind, welche Datenformate benötigt werden und andere relevante Informationen. Wenn Sie das min-Attribut verwenden, stellen Sie sicher, dass diese Mindestanforderung vom Benutzer verstanden wird. Das Bereitstellen von Anweisungen innerhalb des <label> kann ausreichend sein. Wenn Sie Anweisungen außerhalb von Labels bereitstellen, 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>