CSS !important: cuándo gana una declaración y cómo comprobarlo

CSS !important marca una declaración concreta como importante. Una declaración importante del autor prevalece sobre una normal del mismo origen, pero dos declaraciones importantes todavía se comparan por el origen, la capa y la especificidad antes del orden.

Marcar una declaración como importante

Escribe !important después del valor y antes del punto y coma. Afecta a esa declaración. En estas dos reglas gana la declaración en rojo oscuro aunque .demo .specificity sea más específica.

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

Reglas del W3C sobre declaraciones importantes

Probar tres conflictos de cascada

Guarda el documento completo en UTF-8 como important-demo.html y ábrelo en el navegador. Estas pruebas usan estilos del autor.

<!doctype html>
<html lang="es">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Comparación de declaraciones 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>Comparación de declaraciones importantes</h1>
  <p class="specificity" style="color: #166534">Conflicto con un estilo en línea normal</p>
  <p class="tie">Dos reglas importantes con el mismo selector</p>
  <p class="layered">Reglas importantes de capas distintas</p>
</main>
</body>
</html>
  1. La primera línea se ve en rojo oscuro. Quita !important de .specificity para ver el verde del estilo en línea. Quita también ese estilo para ver el azul del selector más específico. Restaura ambos cambios.
  2. La segunda línea es azul. Las dos declaraciones .tie comparten selector e importancia, así que gana la posterior. Desactívala para ver el rojo oscuro.
  3. La tercera línea es de color rojo oscuro. Las dos capas usan declaraciones importantes y gana la primera capa, vendor. Retira !important solo de esa regla para ver el azul de app.

Resolver conflictos entre declaraciones importantes

La especificidad mide cuán concreto es un selector. Si coinciden los criterios anteriores, como el origen y la capa, gana la declaración importante con mayor especificidad. El orden deshace el empate final. Un estilo importante en línea del autor se impone a sus reglas importantes de hojas de estilo.

Las capas ordenan grupos de reglas. En las declaraciones normales ganan las capas posteriores. En las importantes ganan las primeras capas, incluso frente a reglas importantes sin capa. Las reglas importantes del usuario prevalecen sobre las del autor. Una transición activa puede tener mayor prioridad.

Orden de la cascada según el W3C · Orden de las capas según el W3C

Localizar la regla ganadora en el navegador

  1. Inspecciona la propiedad del elemento y compara su valor calculado con las reglas tachadas.
  2. Si controlas el CSS, ajusta primero el selector o las capas. Si una biblioteca externa usa reglas normales, puedes colocarlas en una capa anterior.
  3. Si necesitas una declaración importante, limítala al componente y a la propiedad, documenta el motivo y prueba los estados y temas relevantes.