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

CKTIS / JavaScript

HTMLInputElement.max e disabled: limite de valor e desativação do campo

`max` reflete o limite superior como texto e `disabled` indica se o campo tem o seu próprio atributo de desativação. Ultrapassar o limite não desativa o campo.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

input.max;                 // string: the max attribute, or "" if absent
input.max = "10";          // set the max attribute
input.removeAttribute("max");
input.disabled;            // boolean: whether the input's own disabled attribute is present
input.disabled = true;     // add the disabled attribute
input.disabled = false;    // remove the disabled attribute
input.matches(":disabled"); // test whether the input is effectively disabled

input.max é uma propriedade modificável do tipo cadeia de caracteres que reflete o atributo HTML max. Devolve o texto do atributo, ou "" se estiver ausente, e não o limite calculado. input.max = "10" define o atributo e input.removeAttribute("max") remove-o.

max aplica-se aos tipos number, range, date, month, week, time e datetime-local; o formato depende do tipo. Não limita o comprimento do texto. Se o atributo estiver ausente ou não puder ser interpretado, aplica-se o limite predefinido do tipo, quando existe: 100 para range; number não tem limite predefinido. Num campo number, um número acima do limite permanece em value e faz com que validity.rangeOverflow === true. Já um controlo deslizante range ajusta o valor ao intervalo. Um intervalo time com min superior a max pode atravessar a meia-noite.

A propriedade booleana modificável input.disabled reflete a presença do atributo disabled no próprio campo. true adiciona-o e false remove-o. Mesmo disabled="false" desativa o campo. Um fieldset desativado também desativa os campos descendentes, exceto os que estão dentro do seu primeiro filho direto legend. Por isso, input.disabled pode ser false mesmo quando input.matches(":disabled") devolve true.

O utilizador não pode focar nem editar um campo desativado, mas o JavaScript pode continuar a alterar o seu valor. O campo fica excluído da validação de restrições (willValidate é false) e é omitido no envio do formulário e em new FormData(form). Estas propriedades pertencem ao DOM do navegador, não ao ECMAScript; um ambiente sem DOM não as disponibiliza. Valida sempre os dados recebidos no servidor, independentemente da configuração do campo.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Input max and disabled</title>
</head>
<body>
  <script>
    const form = document.createElement('form');
    const input = document.createElement('input');
    input.type = 'number';
    input.name = 'quantity';
    input.max = '10';
    input.value = '12';
    form.append(input);

    console.log(JSON.stringify([
      input.max, input.value, input.validity.rangeOverflow,
      input.checkValidity(), new FormData(form).has('quantity'),
    ]));

    input.disabled = true;
    console.log(JSON.stringify([
      input.disabled, input.value, input.willValidate,
      new FormData(form).has('quantity'),
    ]));
  </script>
</body>
</html>

Resultado

["10","12",true,false,true]
[true,"12",false,false]

Guarda o exemplo como ficheiro `.html`, abre-o num navegador e verifica o resultado na consola do navegador. `"12"` ultrapassa `"10"` e não passa na validação, mas continua a ser incluído em `FormData`. Depois de desativado, o campo conserva o valor, mas fica excluído da validação e dos dados do formulário.

Lições relacionadas

  • JavaScript · Lição 28 · Intermédio · Versão: 3

Fontes