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>
- A primeira linha é vermelho-escura. Remova
!importantde.specificitypara 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. - A segunda linha é azul. As duas regras
.tietêm a mesma importância e o mesmo seletor, então a posterior prevalece. Desative-a para ver o vermelho-escuro. - A terceira linha é vermelho-escura. As duas camadas têm declarações importantes, então
vendor, a primeira, prevalece. Remova!importantapenas dessa regra para ver o azul deapp.
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
- Inspecione o elemento e localize a propriedade. Compare seu valor calculado com as declarações riscadas no painel de estilos.
- 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.
- Se uma declaração importante for necessária, limite-a ao componente e à propriedade. Registre o motivo e teste os estados e temas relevantes.




