WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

max — obere Wertgrenze

Das Attribut max legt die obere Grenze für bestimmte input-Typen, eine meter-Skala oder den Fortschritt einer Aufgabe fest. Format, Standardwerte und Folgen einer Überschreitung hängen vom Element ab.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

input: max="upper-bound"; meter: max="number"; progress: max="positive-number"

max legt eine obere Grenze fest, nicht die Textlänge — dafür ist maxlength zuständig. Bei input gilt es für number, range, date, month, week, time und datetime-local. Der Wert muss dem Format des Typs entsprechen, zum Beispiel 10, 2026-12-31 oder 18:00.

Bei einem gewöhnlichen Bereich führt ein Wert über dem Maximum zu validity.rangeOverflow. max verhindert nicht unbedingt, dass ein solcher Wert eingegeben wird. Ein fehlender oder ungültiger Wert bedeutet, dass es kein Maximum gibt, sofern der Typ keinen Standardwert festlegt: Bei range ist der Standard 100, und der Wert wird auf den zulässigen Bereich begrenzt. Normalerweise darf max nicht kleiner als min sein; eine Ausnahme ist time, bei dem ein umgekehrter Bereich Mitternacht überschreiten kann.

Bei meter legt das Attribut das Ende einer Messskala fest und muss eine gültige Gleitkommazahl sein, die nicht kleiner als min ist. Fehlt das Attribut oder lässt es sich nicht auslesen, verwendet der Browser als Ersatzmaximum 1 und erhöht das effektive Maximum bei Bedarf auf den Mindestwert.

Bei progress bezeichnet max die gesamte Arbeitsmenge und muss eine gültige Zahl größer als null sein. Bei fehlendem oder ungültigem Wert gilt ein Maximum von 1. Fehlt value, ist der Fortschritt unbestimmt, auch wenn max gesetzt ist. Verwende meter für Messwerte und progress für den Fortschritt einer Aufgabe.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>max</title>
<label>Input: <input id="quantity" type="number" max="10" value="11"></label>
<label>Meter: <meter id="gauge" min="0" max="10" value="7">7/10</meter></label>
<label>Progress: <progress id="task" max="10" value="7">7/10</progress></label>
<pre id="result"></pre>
<script>
  const quantity = document.getElementById('quantity');
  const gauge = document.getElementById('gauge');
  const task = document.getElementById('task');
  document.getElementById('result').textContent = [
    `rangeOverflow: ${quantity.validity.rangeOverflow}`,
    `meter max: ${gauge.max}`,
    `progress position: ${task.position}`
  ].join('\n');
</script>

Ergebnis

rangeOverflow: true
meter max: 10
progress position: 0.7

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen