HTML-Attribut: max
Das max
-Attribut definiert den maximal akzeptablen und gültigen Wert für die Eingabe, die das Attribut enthält. Wenn der value
des Elements größer als dieser Wert ist, schlägt die Validierung des Elements fehl. Dieser Wert muss größer oder gleich dem Wert des min
Attributs sein. Ist das max
-Attribut vorhanden, aber nicht angegeben oder ungültig, wird kein max
-Wert angewendet. Wenn das max
-Attribut gültig ist und ein nicht-leerer Wert größer als der maximal vom max
-Attribut erlaubte Wert ist, verhindert die Eingabeeinschränkungsvalidierung, dass das Formular abgeschickt wird.
Das max
-Attribut ist gültig für numerische Eingabetypen, einschließlich der date, month, week, time, datetime-local, number und range Typen, und sowohl das <progress>
als auch das <meter>
Element. Es ist eine Zahl, die angibt, welchen höchsten positiven Wert ein Formularsteuerelement als gültig betrachtet werden soll.
Wenn der Wert den erlaubten Maximalwert überschreitet, ist der validityState.rangeOverflow
true und das Steuerelement wird durch die :out-of-range
und :invalid
Pseudoklassen erfasst.
Syntax
Eingabetyp | Syntax | Beispiel |
---|---|---|
date | yyyy-mm-dd |
<input type="date" max="2019-12-25" step="1"> |
month | yyyy-mm |
<input type="month" max="2019-12" step="12"> |
week | yyyy-W## |
<input type="week" max="2019-W23" step=""> |
time | HH:mm |
<input type="time" max="17:00" step="900"> |
datetime-local | yyyy-mm-ddTHH:mm |
<input type="datetime-local" max="2019-12-25T23:59">
|
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 Höchstwert entsprechen, wird der Wert in der Eingabeeinschränkungsvalidierung als ungültig betrachtet und entspricht den :invalid
und :out-of-range
Pseudoklassen.
Weitere Informationen finden Sie in der clientseitigen Validierung und rangeOverflow
.
Für das <progress>
-Element beschreibt das max
-Attribut, wie viel Arbeit die durch das progress
-Element angezeigte Aufgabe erfordert. Ist es vorhanden, muss es einen Wert größer als null haben und eine gültige Gleitkommazahl sein. Für das <meter>
-Element definiert das max
-Attribut die obere numerische Begrenzung des gemessenen Bereichs. Dieser Wert muss größer als der Mindestwert (min
Attribut) sein, falls angegeben. In beiden Fällen wird der Wert, wenn er weggelassen wird, standardmäßig auf 1 gesetzt.
Eingabetyp | Syntax | Beispiel |
---|---|---|
<progress> |
<number> |
<progress id="file" max="100" value="70"> 70%
</progress>
|
<meter> |
<number> |
<meter id="fuel" min="0" max="100" low="33" high="66"
optimum="80" value="40"> bei 40/100</meter>
|
Barrierefreiheit
Geben Sie Anweisungen, um Nutzern zu helfen, das Formular auszufüllen und einzelne Formularsteuerelemente zu verwenden. Geben Sie an, welche Eingaben erforderlich und welche optional sind, Datenformate und andere relevante Informationen. Wenn Sie das max
-Attribut verwenden, stellen Sie sicher, dass diese maximale Anforderung vom Benutzer verstanden wird. 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
in Betracht ziehen.
Spezifikationen
Specification |
---|
HTML # attr-input-max |
HTML # attr-meter-max |
HTML # attr-progress-max |
Browser-Kompatibilität
html.elements.input.max
html.elements.meter.max
html.elements.progress.max
Siehe auch
step
min
- andere Meter-Attribute:
low
,high
,optimum
- Einschränkungen Validierung
- Formularvalidierung
validityState.rangeOverflow
:out-of-range
<input>
- date, month, week, time, datetime-local, number und range Typen, und das
<meter>