HTML-Attribut: max

Das max-Attribut definiert den maximal zulässigen Wert, der für das Eingabefeld mit dem 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 aber nicht angegeben oder ungültig ist, wird kein max-Wert angewendet. Falls das max-Attribut gültig ist und ein nicht leerer Wert größer ist als das Maximum, das durch das max-Attribut erlaubt ist, wird die Constraint-Validierung die Formularübermittlung verhindern.

Das max-Attribut ist für die numerischen Eingabetypten gültig, einschließlich der date, month, week, time, datetime-local, number und range Typen, und sowohl für die <progress> als auch die <meter> Elemente. Es ist eine Zahl, die den maximal positiven Wert angibt, den ein Formular-Steuerelement als gültig betrachtet.

Wenn der Wert den maximal erlaubten Wert überschreitet, wird validityState.rangeOverflow wahr sein, und das Steuerelement wird durch die :out-of-range und :invalid Pseudoklassen erfasst.

Syntax

Syntax für max Werte je nach Eingabe- type
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 von den Benutzern eingegebenen Daten nicht dem festgelegten Maximalwert entsprechen, wird der Wert bei der Constraint-Validierung als ungültig betrachtet und entspricht den :invalid und :out-of-range Pseudoklassen.

Weitere Informationen finden Sie unter Client-side validation und rangeOverflow.

Für das <progress>-Element beschreibt das max-Attribut, wie viel Arbeit die durch das progress-Element angezeigte Aufgabe erfordert. Falls vorhanden, muss es einen Wert größer als null haben und eine gültige Fließkommazahl sein. Für das <meter>-Element definiert das max-Attribut die obere numerische Grenze des gemessenen Bereichs. Dieser muss größer sein als der Mindestwert (min Attribut), falls angegeben. In beiden Fällen, falls nicht angegeben, beträgt der Standardwert 1.

Syntax für max Werte für andere Elemente
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>

Barrierefreiheitsbedenken

Geben Sie Anweisungen, um den Benutzern zu helfen zu verstehen, wie man das Formular ausfüllt und einzelne Formularelemente verwendet. Geben Sie an, welche Eingaben erforderlich und optional sind, Datenformate und andere relevante Informationen. Wenn Sie das max-Attribut verwenden, stellen Sie sicher, dass dieses maximale Erfordernis 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, sollten Sie erwägen, aria-labelledby oder aria-describedby zu verwenden.

Spezifikationen

Specification
HTML Standard
# attr-input-max
HTML Standard
# attr-meter-max
HTML Standard
# attr-progress-max

Browser-Kompatibilität

html.elements.input.max

BCD tables only load in the browser

html.elements.meter.max

BCD tables only load in the browser

html.elements.progress.max

BCD tables only load in the browser

Siehe auch