Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

:disabled — pseudoclasse degli elementi disabilitati

La pseudoclasse :disabled seleziona gli elementi effettivamente disabilitati secondo le regole HTML, non solo quelli che hanno un attributo disabled. Permette di applicare stili allo stato di un controllo, ma non lo disabilita autonomamente.

Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintassi

:disabled

La pseudoclasse :disabled corrisponde agli elementi dell’interfaccia nello stato disabilitato definito dal linguaggio del documento. In HTML comprende gli elementi button, input, select, textarea, optgroup, option e fieldset effettivamente disabilitati, oltre agli elementi personalizzati associati a un modulo. button:disabled limita la corrispondenza ai pulsanti.

Non confondere :disabled con [disabled]: il secondo selettore controlla soltanto la presenza dell’attributo. Un controllo all’interno di un fieldset disabilitato può corrispondere a :disabled anche senza un proprio attributo disabled. La disabilitazione tramite quel fieldset non si applica ai discendenti del suo primo elemento figlio legend; questi possono comunque essere disabilitati per un altro motivo. L’esempio mostra questa differenza.

Il selettore rileva soltanto lo stato: una regola CSS non disabilita un controllo. Proprietà come display e visibility non modificano la corrispondenza con :disabled. Anche readonly da solo non significa che un elemento sia disabilitato. :enabled non equivale a :not(:disabled) per tutti gli elementi: un normale paragrafo non corrisponde né a :enabled né a :disabled, ma corrisponde a :not(:disabled).

Nell’esempio, i pulsanti inherited e direct ricevono un contorno rosso e il risultato testuale è inherited, direct. Il pulsante exception beneficia dell’eccezione relativa al primo legend, mentre available rimane abilitato. Il risultato testuale è stato verificato eseguendo l’esempio in un browser in ambiente isolato.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:disabled example</title>
<style>
  button:disabled { outline: 3px solid #b00020; }
</style>
<fieldset disabled>
  <legend><button id="exception" type="button">Exception</button></legend>
  <button id="inherited" type="button">Inherited</button>
</fieldset>
<button id="direct" type="button" disabled>Direct</button>
<button id="available" type="button">Available</button>
<pre id="result"></pre>
<script>
  const ids = Array.from(document.querySelectorAll('button:disabled'),
    button => button.id);
  document.getElementById('result').textContent = ids.join(', ');
</script>
</html>

Risultato

inherited, direct

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