CSS !important: quando uma declaração tem prioridade

CSS !important marca uma declaração como importante. Uma declaração importante do autor prevalece sobre uma normal da mesma origem. Entre declarações importantes, a origem, a camada e a especificidade podem decidir o resultado antes da ordem do código.

Marcar uma declaração como importante

Coloque !important depois do valor e antes do ponto e vírgula. A marca vale para aquela declaração. Nas regras abaixo, o vermelho-escuro prevalece mesmo que .demo .specificity seja mais específico.

.demo .specificity { color: #0369a1; }
.specificity { color: #9f1239 !important; }

Regras do W3C para declarações importantes

Executar três comparações no navegador

Salve o arquivo completo como important-demo.html, em UTF-8, e abra-o no navegador. As comparações usam estilos do autor.

<!doctype html>
<html lang="pt-BR">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Comparação de declarações importantes</title>
<style>
body {
  margin: 2rem auto;
  max-width: 38rem;
  padding-inline: 1rem;
  font: 1rem/1.6 system-ui, sans-serif;
  background: #fff;
}
@layer vendor, app;

@layer vendor {
  .layered { color: #9f1239 !important; }
}
@layer app {
  .layered { color: #0369a1 !important; }
}

.demo .specificity { color: #0369a1; }
.specificity { color: #9f1239 !important; }

.tie { color: #9f1239 !important; }
.tie { color: #0369a1 !important; }
</style>
</head>
<body>
<main class="demo">
  <h1>Comparação de declarações importantes</h1>
  <p class="specificity" style="color: #166534">Conflito com um estilo em linha normal</p>
  <p class="tie">Duas declarações importantes com o mesmo seletor</p>
  <p class="layered">Declarações importantes em camadas diferentes</p>
</main>
</body>
</html>
  1. A primeira linha é vermelho-escura. Remova !important de .specificity para ver o verde do estilo em linha. Remova também esse estilo para ver o azul do seletor mais específico. Restaure as duas alterações.
  2. A segunda linha é azul. As duas regras .tie têm a mesma importância e o mesmo seletor, então a posterior prevalece. Desative-a para ver o vermelho-escuro.
  3. A terceira linha é vermelho-escura. As duas camadas têm declarações importantes, então vendor, a primeira, prevalece. Remova !important apenas dessa regra para ver o azul de app.

Comparar várias declarações importantes

A especificidade mede quão preciso é um seletor. Se os critérios anteriores, como origem e camada, estiverem empatados, prevalece a declaração importante mais específica. A ordem do código resolve o empate final. Uma declaração importante em linha do autor tem prioridade sobre regras importantes de suas folhas de estilo.

As camadas organizam grupos de regras. Declarações normais favorecem camadas posteriores. Declarações importantes favorecem as primeiras e ficam acima de declarações importantes sem camada. Declarações importantes do usuário prevalecem sobre as do autor. Uma transição ativa pode ter prioridade ainda maior.

Ordem da cascata segundo o W3C · Ordem das camadas segundo o W3C

Identificar a regra nas ferramentas do navegador

  1. Inspecione o elemento e localize a propriedade. Compare seu valor calculado com as declarações riscadas no painel de estilos.
  2. Se você controla o CSS, ajuste primeiro o alcance do seletor ou a ordem das camadas. Regras normais de bibliotecas externas podem ficar em uma camada anterior.
  3. Se uma declaração importante for necessária, limite-a ao componente e à propriedade. Registre o motivo e teste os estados e temas relevantes.