Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Controlli del modulo disabilitati

Gli utenti non possono usare i controlli del modulo disabilitati né spostarvi il focus, e i valori di questi controlli non vengono inviati. In JavaScript, la proprietà `disabled` cambia lo stato di disabilitazione proprio del controllo, ma anche un `fieldset` che lo contiene può disabilitarlo.

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

control.disabled = true;
control.disabled = false;
control.matches(':disabled');

I controlli del modulo disabilitati sono controlli a cui è stata applicata la disabilitazione. Gli utenti non possono modificarli né attivarli con un clic; non possono ricevere il focus e non partecipano alla convalida dei vincoli. I loro valori vengono omessi quando si invia il modulo. È un meccanismo di HTML e del DOM del browser, non una funzionalità di una specifica edizione di ECMAScript. MDN indica che HTMLInputElement.disabled è ampiamente disponibile nei browser da luglio 2015; la presenza di Node 24 non dimostra il supporto del DOM.

La proprietà input.disabled è un valore booleano che riflette l’attributo disabled proprio dell’elemento. Assegnarle true aggiunge l’attributo, mentre assegnarle false lo rimuove. L’attributo è booleano: anche disabled="false" significa disabilitato, perché conta la presenza dell’attributo, non il suo valore testuale.

Un fieldset disabilitato disabilita anche i controlli discendenti, tranne quelli all’interno del primo elemento legend che è figlio diretto di quel fieldset. Il solo fatto che un controllo si trovi nel legend di un fieldset annidato non impedisce al fieldset esterno di disabilitarlo. Di conseguenza, input.disabled può essere false mentre un elemento antenato disabilita ancora il controllo; usa input.matches(':disabled') per verificarne lo stato effettivo. Assegnare soltanto input.disabled = false non annulla la disabilitazione imposta da un fieldset.

Non confondere disabled con readonly: i campi di sola lettura compatibili possono comunque ricevere il focus e contribuire con i propri valori all’invio del modulo. readonly si applica ai tipi testuali di input e a textarea, ma non, per esempio, a select o button. L’esempio mostra come alternare disabled e la conseguente omissione del campo da FormData.

Esempi

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

Risultato

true
false
JavaScript

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