CKTIS / JavaScript
HTMLInputElement.max y disabled: límite de valor y desactivación de campos
`max` refleja el límite superior como texto y `disabled` indica si el campo tiene su propio atributo de desactivación. Superar el límite no desactiva el campo.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
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 es una propiedad de cadena que se puede modificar y que refleja el atributo HTML max. Devuelve el texto del atributo, o "" si no existe, no el límite calculado. input.max = "10" establece el atributo y input.removeAttribute("max") lo elimina.
max se aplica a number, range, date, month, week, time y datetime-local, con un formato propio de cada tipo. No limita la longitud del texto. Si el atributo falta o no se puede interpretar, se usa el máximo predeterminado del tipo, si existe: 100 para range; number no tiene ninguno. En un campo number, un número superior al límite permanece en value y hace que validity.rangeOverflow === true. Un control deslizante range, en cambio, ajusta su valor al intervalo. Un intervalo time con min mayor que max puede abarcar la medianoche.
La propiedad booleana modificable input.disabled refleja la presencia del atributo disabled en el propio campo. true lo añade y false lo elimina. Incluso disabled="false" desactiva el campo. Un fieldset desactivado también desactiva los campos descendientes, salvo los que están dentro de su primer hijo directo legend. Por eso input.disabled puede valer false aunque input.matches(":disabled") devuelva true.
El usuario no puede enfocar ni editar un campo desactivado, pero JavaScript aún puede cambiar su valor. El campo no participa en la validación de restricciones (willValidate vale false) y se omite tanto al enviar el formulario como al crear new FormData(form). Son propiedades del DOM del navegador, no de ECMAScript; un entorno sin DOM no las proporciona. Valida siempre los datos recibidos en el servidor, independientemente de la configuración del campo.
Ejemplos
<!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 el ejemplo como archivo `.html`, ábrelo en un navegador y comprueba el resultado en la consola del navegador. `"12"` supera `"10"` y no pasa la validación, pero `FormData` todavía lo incluye. Al desactivar el campo, este conserva su valor, pero queda excluido de la validación y de los datos del formulario.
Lecciones relacionadas
- JavaScript · Lección 28 · Intermedio · Versión: 3
Fuentes
- 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