Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

:disabled — pseudoclasse dos elementos desativados

A pseudoclasse :disabled seleciona os elementos efetivamente desativados segundo as regras HTML, e não apenas os elementos que têm o atributo disabled. Permite estilizar o estado de um controlo, mas não o desativa por si só.

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

Sintaxe

:disabled

A pseudoclasse :disabled corresponde aos elementos da interface no estado desativado definido pela linguagem do documento. Em HTML, abrange os elementos button, input, select, textarea, optgroup, option e fieldset efetivamente desativados, bem como elementos personalizados associados a formulários. button:disabled limita a correspondência aos botões.

Não confundas :disabled com [disabled]: o segundo seletor verifica apenas se o atributo está presente. Um controlo dentro de um fieldset desativado pode corresponder a :disabled sem ter o seu próprio atributo disabled. A desativação por esse fieldset não abrange os descendentes do seu primeiro elemento filho legend; estes podem continuar desativados por outro motivo. O exemplo demonstra esta diferença.

O seletor apenas deteta o estado — uma regra CSS não desativa um controlo. Propriedades como display e visibility não alteram a correspondência com :disabled. Da mesma forma, readonly, por si só, não significa que o elemento esteja desativado. :enabled não equivale a :not(:disabled) para todos os elementos: um parágrafo normal não corresponde nem a :enabled nem a :disabled, mas corresponde a :not(:disabled).

No exemplo, os botões inherited e direct recebem um contorno vermelho, e o resultado textual é inherited, direct. O botão exception beneficia da exceção relativa ao primeiro legend, enquanto available permanece ativado. O resultado textual foi verificado num navegador em ambiente isolado.

Exemplos

<!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>

Resultado

inherited, direct

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes