Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

@scope — ámbito de selectores con límite inferior

La regla @scope restringe las reglas de estilo anidadas a un fragmento definido por raíces y límites inferiores opcionales.

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

@scope <scope-boundaries>? {
  <block-contents>
}
<scope-boundaries> = [ [ ( <scope-start> ) ]? [ to ( <scope-end> ) ]? ]!

@scope <scope-boundaries>? { <block-contents> } crea un ámbito independiente para cada elemento que coincide con el selector inicial. La raíz se incluye, mientras que un elemento que coincide con el selector final y el subárbol completo quedan excluidos. Si se omite el selector inicial, la raíz suele ser el padre del nodo propietario de la hoja. Los pseudoelementos no pueden ser raíces ni límites y una entrada no válida hace fallar las listas de selectores no tolerantes del preámbulo.

Los selectores internos solo coinciden con sujetos que siguen dentro del ámbito y son relativos a la raíz de forma predeterminada. :scope coincide con la raíz; & actúa como :where(:scope), por lo que no añade especificidad. El selector del preámbulo no aumenta la especificidad de una regla interna. En la cascada se compara primero la especificidad, después la proximidad de la raíz y por último el orden de origen.

Así puede aislarse un componente, una región temática o un fragmento sin añadir clases a cada descendiente. El ejemplo comienza en .card y termina antes de .nested. El párrafo directo se vuelve verde, pero el párrafo tras el límite y el elemento exterior siguen negros. El preámbulo to (.nested) y las propiedades de CSSScopeRule confirman ambos límites.

Ejemplos

const style = document.createElement('style');
style.textContent = `p { color: rgb(0 0 0); }
@scope (.card) to (.nested) { p { color: rgb(0 128 0); } }`;
document.head.append(style);
const card = document.createElement('section');
card.className = 'card';
card.innerHTML = '<p class="direct">direct</p><div class="nested"><p class="limited">limited</p></div>';
const outside = document.createElement('p');
outside.textContent = 'outside';
document.body.append(card, outside);
const rule = style.sheet.cssRules[1];
console.log('rule=' + rule.constructor.name + '; start=' + rule.start + '; end=' + rule.end + '; direct=' + getComputedStyle(card.querySelector('.direct')).color + '; limited=' + getComputedStyle(card.querySelector('.limited')).color + '; outside=' + getComputedStyle(outside).color);

Resultado

rule=CSSScopeRule; start=.card; end=.nested; direct=rgb(0, 128, 0); limited=rgb(0, 0, 0); outside=rgb(0, 0, 0)

La regla @scope restringe las reglas de estilo anidadas a un fragmento definido por raíces y límites inferiores opcionales.

Fuentes