HTML-Attribut: max

Das max-Attribut definiert den maximal akzeptablen und gültigen Wert für das Eingabefeld, das das Attribut enthält. Wenn der value des Elements größer ist als dieser Wert, schlägt das Element bei der Validierung 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, verhindert die Einschränkungsvalidierung die Formularübermittlung.

Das max-Attribut ist gültig für die numerischen Eingabetypen, einschließlich der date, month, week, time, datetime-local, number und range Typen sowie für die Elemente <progress> und <meter>. Es handelt sich um eine Zahl, die den positivsten Wert angibt, den ein Formularsteuerelement als gültig betrachtet.

Wenn der Wert den erlaubten Maximalwert überschreitet, wird validityState.rangeOverflow wahr, und die Steuerung wird durch die Pseudoklassen :out-of-range und :invalid abgeglichen.

Syntax

Syntax für max Werte 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 vom Benutzer eingegebenen Daten nicht dem festgelegten Maximalwert entsprechen, wird der Wert bei der Einschränkungsvalidierung als ungültig betrachtet und wird den Pseudoklassen :invalid und :out-of-range entsprechen.

Siehe Client-seitige Validierung und rangeOverflow für weitere Informationen.

Für das <progress>-Element beschreibt das max-Attribut, wie viel Arbeit die von dem progress-Element angezeigte Aufgabe erfordert. Wenn 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 Grenze des gemessenen Bereichs. Dies muss größer als der minimale Wert (min Attribut) sein, falls angegeben. In beiden Fällen wird der Wert standardmäßig auf 1 gesetzt, wenn er weggelassen wird.

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"> at 40/100</meter>

Barrierefreiheit

Stellen Sie Anweisungen zur Verfügung, um den Benutzern zu helfen, das Formular auszufüllen und individuelle Formularelemente zu verwenden. Geben Sie alle erforderlichen und optionalen Eingaben, Datenformate und andere relevante Informationen an. Wenn Sie das max-Attribut verwenden, stellen Sie sicher, dass dieser Maximalwert vom Benutzer verstanden wird. Anweisungen innerhalb des <label> können ausreichend sein. Wenn Anweisungen außerhalb der Labels bereitgestellt werden, was eine flexiblere Positionierung und Gestaltung ermöglicht, sollten Sie die Verwendung von 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

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