CKTIS / JavaScript
HTMLButtonElement.disabled — deshabilitar un botón
HTMLButtonElement.disabled es una propiedad booleana que refleja la presencia del atributo disabled de un botón. Permite deshabilitar un botón o quitar su propio atributo disabled, pero no describe todos los motivos por los que el control puede estar deshabilitado.
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
button.disabled; button.disabled = true; button.disabled = false;HTMLButtonElement.disabled es una propiedad booleana, de lectura y escritura, de la interfaz del botón. Refleja el atributo disabled propio del botón: asignar true añade el atributo y asignar false lo elimina. Es una API del navegador definida por el HTML Standard, no una característica de ECMAScript en sí; disponer de Node 24 no demuestra que esta API sea compatible.
Un botón deshabilitado no responde a la activación habitual del usuario, y su pareja nombre-valor no se envía con el formulario. El atributo es booleano: importa que esté presente, no su valor textual. Por eso, button.setAttribute('disabled', 'false') sigue deshabilitando el botón; usa button.disabled = false para quitar el atributo.
El valor de la propiedad no permite comprobar por completo si el botón está efectivamente deshabilitado. Un botón puede tener disabled === false y, aun así, estar deshabilitado por un fieldset antecesor que tenga el atributo disabled. Los descendientes del primer elemento legend que sea hijo de ese fieldset están exentos de ese efecto de deshabilitación. Asignar únicamente button.disabled = false no anula la deshabilitación heredada de un antecesor.
Ejemplos
const button = document.createElement('button');
button.type = 'button';
console.log(button.disabled);
button.disabled = true;
console.log(button.disabled, button.hasAttribute('disabled'));
button.disabled = false;
console.log(button.disabled, button.hasAttribute('disabled'));
button.setAttribute('disabled', 'false');
console.log(button.disabled);Resultado
false true true false 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.