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
- HTMLInputElement - Web APIs | MDN
- HTMLInputElement: validationMessage property - Web APIs | MDN
- HTMLInputElement: minLength property - Web APIs | MDN
- HTMLInputElement: type property - Web APIs | MDN
- HTMLInputElement: checked property - Web APIs | MDN
- HTMLInputElement: max property - Web APIs | MDN
- HTMLInputElement: disabled property - Web APIs | MDN
- minlength HTML attribute - HTML | MDN