Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes