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 ist als dieser, schlägt die Validierung des Elements fehl. Dieser Wert muss kleiner oder gleich dem Wert des max
-Attributs sein.
Einige Eingabetypen haben ein standardmäßiges Minimum. Wenn die Eingabe kein standardmäßiges Minimum hat 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 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 vom Benutzer eingegebenen Daten nicht dem festgelegten Minimalwert entsprechen, wird der Wert als ungültig in der Einschränkungsvalidierung betrachtet und passt zu den :invalid
- und :out-of-range
-Pseudoklassen.
Siehe Client-seitige 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 maximale Wert (wenn das max
-Attribut angegeben ist). In beiden Fällen, wenn nicht angegeben, beträgt der Standardwert 1.
Auswirkungen 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 Rahmen um ungültige Eingaben hinzu:
input:invalid {
border: solid red 3px;
}
Dann definieren wir eine Eingabe mit einem minimalen Wert von 7.2, wobei das step-Attribut weggelassen wird, wo es standardmäßig 1 ist.
<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
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 angegeben, beträgt der Standardwert von step
1 für number
und range
sowie 1 Einheitentyp (Sekunde, Woche, Monat, Tag) für die Datum/Zeit-Eingabetypen.
Barrierefreiheitsbedenken
Geben Sie Anweisungen an, um den Benutzern zu helfen, das Formular auszufüllen und die einzelnen Formularsteuerelemente zu nutzen. Geben Sie alle erforderlichen und optionalen Eingaben, Datenformate und andere relevante Informationen an. Beim Verwenden des min
-Attributs stellen Sie sicher, dass diese Mindestanforderung vom Benutzer verstanden wird. Anweisungen innerhalb des <label>
anzugeben, kann ausreichend sein. Wenn Sie Anweisungen außerhalb von Labels bereitstellen, was eine flexiblere Positionierung und Gestaltung ermöglicht, ziehen Sie in Betracht, aria-labelledby
oder aria-describedby
zu 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
step
max
- 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>