HTML-Attribut: max

Das max-Attribut definiert den maximal zulässigen und gültigen Wert für das Eingabefeld, das das Attribut enthält. Wenn der value des Elements größer ist, schlägt die Element-Validierung fehl. Dieser Wert muss größer oder gleich dem Wert des min Attributs sein. Wenn das max-Attribut vorhanden ist, aber nicht angegeben oder ungültig ist, wird kein max-Wert angewendet. Ist das max-Attribut gültig und ein nicht-leerer Wert ist größer als der durch das max-Attribut erlaubte Wert, verhindert die Einschränkungsvalidierung das Absenden des Formulars.

Das max-Attribut ist gültig für numerische Eingabetypen, einschließlich der date, month, week, time, datetime-local, number und range Typen sowie für die <progress> und <meter> Elemente. Es ist eine Zahl, die den höchstzulässigen Wert angibt, damit ein Formularfeld als gültig betrachtet wird.

Wenn der Wert den erlaubten Maximalwert überschreitet, wird validityState.rangeOverflow true sein, und das Kontrollkästchen wird durch die Pseudoklassen :out-of-range und :invalid übereinstimmen.

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 den festgelegten Maximalwert einhalten, wird der Wert bei der Einschränkungsvalidierung als ungültig betrachtet und entspricht den Pseudoklassen :invalid und :out-of-range.

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

Für das <progress>-Element beschreibt das max-Attribut, wie viel Arbeit die vom progress-Element angezeigte Aufgabe erfordert. Falls vorhanden, muss es einen Wert größer als Null und eine gültige Gleitkommazahl haben. Für das <meter>-Element definiert das max-Attribut die obere numerische Begrenzung des gemessenen Bereichs. Dieser muss größer sein als der minimale Wert (Attribut min), falls angegeben. In beiden Fällen, falls nicht angegeben, ist 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>

Zugänglichkeitsbedenken

Geben Sie Anweisungen, um den Benutzern zu helfen, das Formular auszufüllen und die einzelnen Formularelemente zu benutzen. Geben Sie an, welche Eingaben erforderlich und optional sind, welche Datenformate verwendet werden sollen, und weitere relevante Informationen. Wenn Sie das max-Attribut verwenden, stellen Sie sicher, dass diese maximale Anforderung von den Benutzern verstanden wird. Anweisungen innerhalb des <label> zu geben, kann ausreichend sein. Wenn Sie Anweisungen außerhalb von Labels bereitstellen, was mehr Flexibilität bei der Positionierung und Gestaltung ermöglicht, ziehen Sie die Verwendung von aria-labelledby oder aria-describedby in Betracht.

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