CKTIS / JavaScript
Disabilitare i controlli dei moduli HTML con `disabled`
`disabled` disabilita un controllo di un modulo HTML e lo esclude dalla convalida e dai dati del modulo. La proprietà `.disabled` e il selettore `:disabled` verificano aspetti diversi.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
<input name="city" disabled>
<script>
const input = document.querySelector('input[name="city"]');
input.disabled = true;
input.disabled = false;
input.matches(":disabled");
</script>disabled è un attributo booleano di HTML: conta la sua presenza, quindi anche disabled="false" disabilita l’elemento. Vale per elementi come input, button, select, textarea e gli elementi personalizzati associati a un modulo. option e optgroup hanno regole proprie: un optgroup disabilitato rende non selezionabili le sue opzioni senza disabilitare il select stesso.
Un fieldset disabilitato disabilita i controlli discendenti, tranne quelli all’interno del primo elemento legend che ne sia figlio diretto, se presente. In un input, .disabled riflette solo il suo attributo: true lo aggiunge e false lo rimuove. Usa input.matches(":disabled") per verificare lo stato effettivo, compreso l’effetto di un fieldset.
L’utente non può dare il focus a un controllo disabilitato né usarlo normalmente, ma uno script può ancora modificare, per esempio, input.value. Il browser ignora il controllo sia nella convalida dei vincoli sia quando costruisce i dati del modulo, anche con new FormData(form). Nei campi di testo che lo supportano, readonly impedisce all’utente di modificare il campo e lo esclude dalla convalida dei vincoli, ma di per sé non impedisce il focus né lo esclude dai dati del modulo.
Queste funzioni appartengono alla piattaforma web, non a ECMAScript. Disabilitare un controllo non è una misura di sicurezza: convalida i dati e verifica le autorizzazioni sul server.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Disabled form control</title>
</head>
<body>
<script>
const form = document.createElement("form");
const group = document.createElement("fieldset");
const input = document.createElement("input");
input.name = "city";
input.value = "Oslo";
group.append(input);
form.append(group);
const report = () => console.log(JSON.stringify([
input.disabled,
input.matches(":disabled"),
input.willValidate,
new FormData(form).has("city")
]));
group.disabled = true;
report();
group.disabled = false;
report();
</script>
</body>
</html>Risultato
[false,true,false,false] [false,false,true,true]
Ogni riga mostra, nell’ordine, `.disabled`, la corrispondenza con `:disabled`, `.willValidate` e la presenza della voce `city`. Riabilitare il `fieldset` cambia gli ultimi tre risultati; il campo non ha mai un proprio attributo `disabled`.
Lezioni correlate
- JavaScript · Lezione 20 · Intermedio · Versione: 3
- JavaScript · Lezione 21 · Intermedio · Versione: 3