CKTIS / JavaScript
Controles de formulario deshabilitados
Los controles de formulario deshabilitados no pueden ser utilizados ni recibir el foco del usuario, y sus valores no se envían. En JavaScript, la propiedad `disabled` cambia el estado de deshabilitación propio del control, aunque un `fieldset` que lo contenga también puede deshabilitarlo.
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
control.disabled = true;
control.disabled = false;
control.matches(':disabled');Los controles de formulario deshabilitados son controles a los que se ha aplicado la deshabilitación. Los usuarios no pueden editarlos ni activarlos con un clic; no pueden recibir el foco y no participan en la validación de restricciones. Sus valores se omiten al enviar el formulario. Este es un mecanismo de HTML y del DOM del navegador, no una característica de una edición concreta de ECMAScript. MDN indica que HTMLInputElement.disabled está ampliamente disponible en los navegadores desde julio de 2015; la presencia de Node 24 no demuestra que haya compatibilidad con el DOM.
La propiedad input.disabled es un valor booleano que refleja el atributo disabled propio del elemento. Asignarle true añade ese atributo y asignarle false lo elimina. El atributo es booleano: incluso disabled="false" significa que está deshabilitado, porque lo que cuenta es que el atributo esté presente, no su valor textual.
Un fieldset deshabilitado también deshabilita los controles descendientes, excepto los que están dentro del primer elemento legend que sea hijo directo de ese fieldset. El mero hecho de que un control esté dentro del legend de un fieldset anidado no impide que el fieldset exterior lo deshabilite. Por eso, input.disabled puede ser false aunque un elemento antecesor siga deshabilitando el control; usa input.matches(':disabled') para comprobar su estado efectivo. Asignar solo input.disabled = false no anula la deshabilitación impuesta por un fieldset.
No confundas disabled con readonly: los campos compatibles de solo lectura pueden recibir el foco y aportar sus valores al envío del formulario. readonly se aplica a los tipos textuales de input y a textarea, pero no, por ejemplo, a select o button. El ejemplo muestra cómo alternar disabled y cómo, como consecuencia, se omite el campo de FormData.
Ejemplos
const form = document.createElement('form');
const input = document.createElement('input');
input.name = 'topic';
input.value = 'JavaScript';
form.append(input);
input.disabled = true;
console.log(input.disabled);
console.log(new FormData(form).has('topic'));
input.disabled = false;
console.log(new FormData(form).get('topic'));Resultado
true false JavaScript
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.