HTML-Attribut: max
Das max
-Attribut definiert den maximalen Wert, der für die Eingabe mit diesem Attribut akzeptabel und gültig ist. Wenn der value
des Elements größer ist als dieser, schlägt die Validierung des Elements fehl. Dieser Wert muss größer oder gleich dem Wert des min
-Attributs sein. Wenn das max
-Attribut vorhanden ist, aber nicht spezifiziert oder ungültig ist, wird kein max
-Wert angewendet. Wenn das max
-Attribut gültig ist und ein nicht leerer Wert größer ist als der vom max
-Attribut erlaubte Maximalwert, verhindert die Einschränkungsvalidierung das Absenden des Formulars.
Das max-Attribut ist gültig für die numerischen Eingabetypen, einschließlich der Typen date, month, week, time, datetime-local, number und range, sowie für die Elemente <progress>
und <meter>
. Es ist eine Zahl, die den positivsten Wert angibt, den eine Formularkontrolle als gültig betrachtet.
Wenn der Wert den zulässigen Maximalwert überschreitet, ist der validityState.rangeOverflow
wahr, und die Kontrolle wird von den Pseudoklassen :out-of-range
und :invalid
abgeglichen.
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 Maximalwert entsprechen, wird der Wert in der Einschränkungsvalidierung als ungültig betrachtet und entspricht den Pseudoklassen :invalid
und :out-of-range
.
Weitere Informationen finden Sie unter Validierung auf Client-Seite und rangeOverflow
.
Für das <progress>
-Element beschreibt das max
-Attribut, wie viel Arbeit für die durch das progress
-Element angezeigte Aufgabe erforderlich ist. Wenn es vorhanden ist, 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 Grenze des gemessenen Bereichs. Dies muss größer sein als der Mindestwert (das min
-Attribut), falls angegeben. In beiden Fällen wird der Wert standardmäßig auf 1 gesetzt, wenn er ausgelassen wird.
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"> at 40/100</meter>
|
Barrierefreiheitsbedenken
Bieten Sie Anweisungen, um den Benutzern zu helfen zu verstehen, wie sie das Formular ausfüllen und die einzelnen Formularelemente verwenden. Geben Sie an, welche Eingaben erforderlich und optional sind, welche Datenformate zu verwenden sind und alle anderen relevanten Informationen. Achten Sie bei der Verwendung des max
-Attributs darauf, dass diese Anforderung von den Benutzern verstanden wird. Anweisungen im <label>
können hierfür ausreichend sein. Wenn Anweisungen außerhalb von Labels, was eine flexiblere Positionierung und Gestaltung ermöglicht, bereitgestellt werden, sollten Sie aria-labelledby
oder aria-describedby
in Erwägung 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
- Einschränkungsvalidierung
- Formularvalidierung
validityState.rangeOverflow
:out-of-range
<input>
- date, month, week, time, datetime-local, number und range Typen, und das
<meter>