Volver a las notas

CSS @scope: por fin gana el tema más cercano

20 de noviembre de 2026·
cssscopecascadebaseline
Demo en vivoAbrir a pantalla completa

Mete una tarjeta clara dentro de una oscura y verás que un .light h3 pierde contra .dark h3 solo porque .dark aparece después en el archivo. Con @scope gana el tema más cercano. MDN lo considera Baseline desde marzo de 2026, así que funciona en Chrome, Edge, Firefox y Safari.

La demo de arriba lo enseña con tres tarjetas anidadas y un widget incrustado. Cambia el tema de cada tarjeta y luego apaga @scope. Las etiquetas leen el color calculado de cada título, así que muestran lo que ha hecho el navegador de verdad.

El problema que resuelve

Los temas anidados siempre han sido incómodos. Imagina estas reglas:

.t-light h3 { color: #0B0F1A; }
.t-dark h3  { color: #F8FAFC; }

Los dos selectores tienen la misma especificidad (0-1-1). Un h3 dentro de una tarjeta clara que está dentro de una oscura cumple los dos, así que gana la última regla del archivo y el título sale blanco sobre fondo claro. Por eso, al apagar @scope en la demo, el marcador cae a 1/4.

Las soluciones de siempre son subir la especificidad, poner clases tipo BEM en cada elemento o reordenar la hoja de estilos y cruzar los dedos. @scope lo resuelve en la propia cascada.

Cómo funciona

Le das a @scope una raíz y las reglas de dentro solo afectan a los elementos de ese subárbol:

@scope (.t-light) {
  :scope { background: #F1F5F9; color: #334155; }
  h3 { color: #0B0F1A; }
  .chip { background: #0B0F1A; color: #F8FAFC; }
}

@scope (.t-dark) {
  :scope { background: #141B2D; color: #94A3B8; }
  h3 { color: #F8FAFC; }
  .chip { background: rgba(0,212,170,.16); color: #00D4AA; }
}

Hay tres cosas en las que fijarse:

  • :scope selecciona la propia raíz, que aquí es la tarjeta. Ahí va el fondo.
  • Los selectores sueltos, como h3, se comportan como si llevaran :where(:scope) delante. Solo afectan a lo que hay dentro de la raíz y no suman especificidad: un h3 dentro de @scope sigue pesando 0-0-1.
  • La proximidad de ámbito es el nuevo paso de la cascada. Cuando dos reglas con ámbito chocan, gana la que tiene la raíz a menos saltos hacia arriba en el árbol del DOM, aunque aparezca antes en el archivo. Por eso la demo marca 4/4 en modo @scope aunque el bloque .t-dark siga siendo el último.

Ámbito donut: pararse en una frontera

También puedes poner un límite inferior con to:

@scope (.t-light) to (.slot) {
  h3 { color: #0B0F1A; }
}

La raíz se incluye y el límite no, así que no se toca .slot ni nada de lo que hay dentro. MDN lo llama "donut scope". Sirve cuando un componente tiene un hueco para contenido que no es suyo, como un widget incrustado o HTML escrito por usuarios. Activa el donut en la demo: el widget vuelve a ser neutro y las tres tarjetas mantienen su tema.

Limitarlo al padre con un <style> dentro

Si quitas el preludio, un elemento <style> limita sus reglas a su elemento padre:

<section class="article-body">
  <style>
    @scope {
      img { border: 5px solid black; }
    }
  </style>
  <img src="photo.jpg" alt="">
</section>

Solo afecta a las imágenes de esa sección, y no hace falta inventar ningún nombre de clase.

El fallo que me encontré haciendo la demo

La proximidad va después de la especificidad. MDN lo dice claramente: la proximidad de ámbito "se impone al orden en el código, pero a ella se le imponen criterios de más prioridad como la importancia, las capas y la especificidad".

En la primera versión de la demo, el estilo neutro de base era .card h3 { color: #94A3B8; }, con especificidad 0-1-1. El h3 con ámbito pesa 0-0-1, así que la regla base ganaba a todos los temas y todos los títulos salían grises. Lo arreglé bajando la regla base con :where():

:where(.card) h3 { color: #94A3B8; } /* 0-0-1: ahora ganan las reglas con ámbito */

Las reglas sin ámbito cuentan como si estuvieran infinitamente lejos, así que, con la misma especificidad, una regla con ámbito gana al estilo base.

Otras cosas que conviene saber

  • No aísla estilos. @scope limita a qué elementos pueden llegar los selectores, pero no corta la herencia. Un color o un font-family puesto en la raíz sigue heredándose más allá del límite inferior del donut. Si necesitas una frontera de verdad, usa el shadow DOM.
  • No puedes salir del subárbol. Un selector como :scope + p no es válido dentro de @scope.
  • :scope suma peso y & no. Un :scope img explícito tiene especificidad 0-1-1. MDN avisa de que la especificidad de & dentro de @scope ha cambiado según el motor y la versión, así que yo no me fiaría de ella.
  • Soporte. Chrome lo trajo en la versión 118. Firefox lo activó por defecto en la versión 146 (9 de diciembre de 2025). Los datos de compatibilidad de MDN indican Safari 26.4, y las notas de Safari 26.4 incluyen un arreglo para las reglas de @scope que no se aplicaban a <input> y <textarea>. Para navegadores antiguos, la demo comprueba typeof CSSScopeRule !== 'undefined' y muestra un aviso. En CSS real, un plan B razonable es escribir los estilos base para que la página siga funcionando aunque se ignoren las reglas con ámbito.

Qué vigilar

  • Sistemas de diseño. Los temas anidados y las zonas claras dentro de páginas oscuras son el primer uso evidente. Creo que veremos librerías de componentes que usen bloques @scope en vez de prefijos de clase larguísimos.
  • La especificidad de &. Conviene volver a mirar si los motores ya coinciden en cómo se comporta & dentro de @scope.
  • Safari y Firefox antiguos. "Recién disponible" quiere decir últimas versiones. Si en tus analíticas hay muchos iPhone sin actualizar, mantén el plan B.

Fuentes