CKTIS / HTML
max — limite superiore del valore
L’attributo max imposta il limite superiore per alcuni tipi di input, una scala meter o l’avanzamento di un’attività. Il formato del valore, i valori predefiniti e le conseguenze del superamento dipendono dall’elemento.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
input: max="upper-bound"; meter: max="number"; progress: max="positive-number"max imposta un limite superiore, non la lunghezza del testo: a questo serve maxlength. Su input si applica ai tipi number, range, date, month, week, time e datetime-local. Il valore deve rispettare il formato del tipo, per esempio 10, 2026-12-31 o 18:00.
Per un intervallo ordinario, un valore superiore al massimo causa validity.rangeOverflow. max non garantisce che l’inserimento di un valore simile venga impedito. Se il valore manca o non è valido, non c’è un massimo, a meno che il tipo non ne definisca uno predefinito: per range è 100 e il valore viene limitato all’intervallo. Di norma max non può essere minore di min; time fa eccezione, perché un intervallo invertito può attraversare la mezzanotte.
Su meter, l’attributo definisce la fine di una scala di misurazione e deve essere un numero a virgola mobile valido, non inferiore a min. Se l’attributo manca o non può essere interpretato, il browser usa 1 come massimo sostitutivo e, se necessario, innalza il massimo effettivo fino al minimo.
Su progress, max indica la quantità totale di lavoro e deve essere un numero valido maggiore di zero. Se il valore manca o non è valido, il massimo è 1. Se value è omesso, l’avanzamento è indeterminato anche quando max è impostato. Usa meter per le misurazioni e progress per l’avanzamento di un’attività.
Esempi
<!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>Risultato
rangeOverflow: true meter max: 10 progress position: 0.7
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.