Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti