CKTIS / JavaScript
HTMLInputElement: tipo, estado y restricciones del campo
Conoce seis propiedades de HTMLInputElement para elegir el tipo de campo, consultar su estado marcado, establecer restricciones y desactivar un control. Distingue el estado actual de los atributos iniciales, y el mensaje de validación del resultado de la validación en sí.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
input.validationMessage; input.minLength = 3; input.type = "text"; input.checked = true; input.max = "10"; input.disabled = true;HTMLInputElement es la interfaz DOM del navegador para los controles de entrada, no una parte de ECMAScript. type es una cadena que selecciona el tipo de control, como text, number o checkbox; el tipo determina qué otras restricciones se aplican. Estas propiedades están ampliamente disponibles en los navegadores modernos, pero la compatibilidad de la interfaz de cada tipo de campo puede variar. Node 24 por sí solo no demuestra que esta API sea compatible.
minLength es el reflejo numérico del atributo minlength: establece la longitud mínima del texto en unidades de código UTF-16, que no tienen por qué coincidir con los caracteres que percibe el usuario. -1 significa que no hay longitud mínima. Se aplica a los tipos de texto, no exige un valor no vacío si no se usa required, y la validación de texto demasiado corto se refiere a los cambios del usuario, no a una asignación hecha únicamente mediante un script. max es una cadena, como "10", que establece el límite superior de los valores numéricos, de fecha o de hora para los tipos correspondientes; no limita la longitud del texto como lo hace maxLength. Con type="time", las horas siguen un ciclo de 24 horas: si min indica una hora posterior a max, el intervalo permitido va de min a max pasando por la medianoche. Por ejemplo, con min="22:00" y max="02:00", 23:00 está dentro del intervalo aunque sea una hora posterior a max.
checked es un booleano que describe el estado marcado actual de un campo checkbox o radio, no su value textual. El atributo checked especifica el estado predeterminado, reflejado por defaultChecked; cambiar el estado marcado actual no actualiza ese atributo. disabled refleja un atributo booleano: establecerlo en true impide la interacción, excluye el control de los datos del formulario enviados y lo excluye de la validación de restricciones. No equivale a readOnly.
validationMessage es una cadena de solo lectura que contiene un mensaje de error localizado, o "" cuando el control cumple sus restricciones o está excluido de la validación. Por tanto, un mensaje vacío no demuestra que un control desactivado tenga un valor válido. Define un mensaje personalizado con setCustomValidity() y bórralo con setCustomValidity(""). El ejemplo comprueba si el mensaje está vacío en vez de comparar un texto que depende del idioma y no intenta demostrar un error de minLength mediante una asignación de script.
Identificadores de referencia incluidos en esta entrada: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.
Ejemplos
(() => {
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.
Fuentes
- 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