Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

@scope — âmbito de seletores com limite inferior

A regra @scope restringe regras de estilo internas a um fragmento definido por raízes e limites inferiores opcionais.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

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

@scope <scope-boundaries>? { <block-contents> } cria um âmbito separado para cada elemento encontrado pelo seletor inicial. A raiz é incluída, enquanto um elemento encontrado pelo seletor final e toda a sua subárvore ficam excluídos. Sem seletor inicial, a raiz é normalmente o pai do nó proprietário da folha. Pseudoelementos não podem ser raízes nem limites, e uma entrada inválida faz falhar as listas de seletores não tolerantes do preâmbulo.

Os seletores internos só correspondem a sujeitos que permaneçam no âmbito e são relativos à raiz por omissão. :scope corresponde à raiz; & comporta-se como :where(:scope), não acrescentando especificidade. O seletor do preâmbulo não aumenta a especificidade de uma regra interna. Na cascata compara-se primeiro a especificidade, depois a proximidade da raiz e por fim a ordem da fonte.

Assim se isola um componente, região de tema ou fragmento sem adicionar uma classe a cada descendente. O exemplo começa em .card e termina antes de .nested. O parágrafo direto fica verde, mas o parágrafo após o limite e o elemento exterior continuam pretos. O preâmbulo to (.nested) e as propriedades de CSSScopeRule confirmam ambos os limites.

Exemplos

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)

A regra @scope restringe regras de estilo internas a um fragmento definido por raízes e limites inferiores opcionais.

Fontes