Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLButtonElement.disabled — disabilitare un pulsante

HTMLButtonElement.disabled è una proprietà booleana che riflette la presenza dell’attributo disabled di un pulsante. Permette di disabilitare un pulsante o rimuovere il suo attributo disabled, ma non descrive tutti i motivi per cui il controllo può essere disabilitato.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

button.disabled; button.disabled = true; button.disabled = false;

HTMLButtonElement.disabled è una proprietà booleana leggibile e scrivibile dell’interfaccia del pulsante. Riflette l’attributo disabled del pulsante: assegnare true aggiunge l’attributo, mentre assegnare false lo rimuove. È un’API del browser definita dall’HTML Standard, non una funzionalità di ECMAScript in sé; la disponibilità di Node 24 non dimostra che questa API sia supportata.

Un pulsante disabilitato non risponde alla normale attivazione da parte dell’utente e la sua coppia nome-valore non viene inviata con il modulo. L’attributo è booleano: conta la sua presenza, non il suo valore testuale. Pertanto, button.setAttribute('disabled', 'false') continua a disabilitare il pulsante; usa button.disabled = false per rimuovere l’attributo.

Il valore della proprietà non è un test completo dello stato effettivo di disabilitazione. Un pulsante può avere disabled === false e rimanere comunque disabilitato da un fieldset antenato con l’attributo disabled. I discendenti del primo elemento legend figlio di quel fieldset sono esenti da questo effetto di disabilitazione. Impostare soltanto button.disabled = false non annulla la disabilitazione ereditata da un antenato.

Esempi

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);

Risultato

false
true true
false false
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti