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

CKTIS / JavaScript

HTMLInputElement: tipo, estado e restrições do campo

Conheça seis propriedades de HTMLInputElement para escolher o tipo de campo, consultar o estado selecionado, definir restrições e desativar um controlo. Distinga o estado atual dos atributos iniciais e a mensagem de validação do próprio resultado da validação.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

input.validationMessage; input.minLength = 3; input.type = "text"; input.checked = true; input.max = "10"; input.disabled = true;

HTMLInputElement é a interface DOM do navegador para os campos de entrada, não fazendo parte do próprio ECMAScript. type é uma cadeia que seleciona o tipo de controlo, como text, number ou checkbox; o tipo determina as outras restrições aplicáveis. Estas propriedades estão amplamente disponíveis nos navegadores modernos, mas o suporte da interface para cada tipo de campo pode variar. O Node 24, por si só, não comprova o suporte desta API.

minLength é a representação numérica do atributo minlength: define o comprimento mínimo do texto em unidades de código UTF-16, que não correspondem necessariamente aos caracteres percecionados pelo utilizador. -1 significa que não existe um comprimento mínimo. Aplica-se a tipos de texto, não exige um valor não vazio sem required, e a validação de texto demasiado curto diz respeito a alterações do utilizador, não apenas a uma atribuição por script. max é uma cadeia, como "10", que define o limite superior dos valores numéricos, de data ou de hora para os tipos aplicáveis; ao contrário de maxLength, não limita o comprimento do texto. Com type="time", as horas seguem um ciclo de 24 horas: se min indicar uma hora posterior a max, o intervalo permitido vai de min a max, passando pela meia-noite. Por exemplo, com min="22:00" e max="02:00", 23:00 está dentro do intervalo, embora seja uma hora posterior a max.

checked é um valor booleano que descreve o estado selecionado atual de um campo checkbox ou radio, não o seu value textual. O atributo checked especifica o estado predefinido, refletido por defaultChecked; alterar o estado selecionado atual não atualiza esse atributo. disabled reflete um atributo booleano: defini-lo como true impede a interação, exclui o controlo dos dados do formulário enviados e da validação de restrições. Não equivale a readOnly.

validationMessage é uma cadeia só de leitura que contém uma mensagem de erro localizada ou "" quando o controlo satisfaz as restrições ou está excluído da validação. Uma mensagem vazia não prova, portanto, que um controlo desativado tenha um valor válido. Defina uma mensagem personalizada com setCustomValidity() e limpe-a com setCustomValidity(""). O exemplo verifica se a mensagem está vazia em vez de comparar um texto dependente do idioma e não tenta demonstrar um erro minLength através de uma atribuição por script.

Identificadores de referência abrangidos por esta entrada: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.

Exemplos

(() => {
  const text = document.createElement("input");
  text.type = "text";
  text.minLength = 3;
  console.log(text.type, text.minLength);

  const box = document.createElement("input");
  box.type = "checkbox";
  box.checked = true;
  console.log(box.checked, box.defaultChecked);

  const number = document.createElement("input");
  number.type = "number";
  number.max = "10";
  number.value = "11";
  console.log(number.max, number.validity.rangeOverflow);
  console.log(number.validationMessage !== "");

  number.disabled = true;
  console.log(number.disabled, number.willValidate);
  console.log(number.validationMessage === "");
})();

Resultado

text 3
true false
10 true
true
true false
true

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