CKTIS / HTML
max — bovengrens van de waarde
Het attribuut max stelt de bovengrens in voor bepaalde input-typen, een meter-schaal of de voortgang van een taak. De waardeopmaak, standaardwaarden en gevolgen van overschrijding hangen af van het element.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
input: max="upper-bound"; meter: max="number"; progress: max="positive-number"max stelt een bovengrens in, geen maximale tekstlengte — daarvoor is maxlength. Bij input geldt het voor de typen number, range, date, month, week, time en datetime-local. De waarde moet overeenkomen met de opmaak van het type, bijvoorbeeld 10, 2026-12-31 of 18:00.
Bij een gewoon bereik veroorzaakt een waarde boven het maximum validity.rangeOverflow. max garandeert niet dat het invoeren van zo’n waarde wordt tegengehouden. Een ontbrekende of ongeldige waarde betekent dat er geen maximum is, tenzij het type een standaardwaarde definieert: voor range is dat 100, en de waarde ervan wordt tot het bereik begrensd. Normaal gesproken mag max niet kleiner zijn dan min; time is een uitzondering, waarbij een omgekeerd bereik over middernacht kan lopen.
Bij meter bepaalt het attribuut het einde van een meetschaal en moet het een geldig getal met drijvende komma zijn dat niet kleiner is dan min. Als het attribuut ontbreekt of niet kan worden gelezen, gebruikt de browser 1 als vervangend maximum en verhoogt zo nodig het effectieve maximum tot het minimum.
Bij progress betekent max de totale hoeveelheid werk en moet het een geldig getal groter dan nul zijn. Bij een ontbrekende of ongeldige waarde is het maximum 1. Als value ontbreekt, is de voortgang onbepaald, ook wanneer max is ingesteld. Gebruik meter voor metingen en progress voor de voortgang van een taak.
Voorbeelden
<!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>Resultaat
rangeOverflow: true meter max: 10 progress position: 0.7
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.