Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

max — limite superior do valor

O atributo max define o limite superior para determinados tipos de input, uma escala meter ou o progresso de uma tarefa. O formato do valor, os valores predefinidos e as consequências de ultrapassar o limite dependem do elemento.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

max define um limite superior, não o comprimento do texto — essa é a função de maxlength. Em input, aplica-se aos tipos number, range, date, month, week, time e datetime-local. O valor tem de corresponder ao formato do tipo, por exemplo, 10, 2026-12-31 ou 18:00.

Num intervalo comum, um valor acima do máximo provoca validity.rangeOverflow. max não garante que a introdução de um valor desses seja impedida. Se o valor estiver ausente ou for inválido, não existe máximo, salvo se o tipo definir um valor predefinido: em range, o valor predefinido é 100 e o valor é limitado ao intervalo. Normalmente, max não pode ser inferior a min; time é uma exceção, pois permite um intervalo invertido que atravessa a meia-noite.

Em meter, o atributo define o fim de uma escala de medição e tem de ser um número de vírgula flutuante válido, não inferior a min. Se o atributo estiver ausente ou não puder ser interpretado, o navegador utiliza 1 como máximo alternativo e, se necessário, aumenta o máximo efetivo até ao mínimo.

Em progress, max representa a quantidade total de trabalho e tem de ser um número válido superior a zero. Se o valor estiver ausente ou for inválido, o máximo é 1. Se value for omitido, o progresso é indeterminado, mesmo que max esteja definido. Utilize meter para medições e progress para o progresso de uma tarefa.

Exemplos

<!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>

Resultado

rangeOverflow: true
meter max: 10
progress position: 0.7

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes