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 disabledinput.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
- HTMLInputElement: max property
- HTMLInputElement: disabled property
- HTML Standard — The min and max attributes
- HTML Standard — Range state (type=range)
- HTML Standard — Enabling and disabling form controls: the disabled attribute
- HTML Standard — Constructing the entry list
- Using HTML form validation and the Constraint Validation API