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

CKTIS / CSS

@layer — camadas de cascata

A regra @layer cria e ordena camadas de cascata, controlando a precedência de grupos de regras sem depender da especificidade.

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

Sintaxe

@layer [ <layer-name># | <layer-name>?  {
  <stylesheet>
} ]

@layer <layer-name-list>; estabelece a ordem dos nomes e @layer <name> { <stylesheet> } coloca regras numa camada. A primeira ordem é decisiva; reabrir uma camada acrescenta regras sem a mover. Camadas anónimas mantêm posição mas não reabrem por nome. As camadas podem ser aninhadas e endereçadas com pontos.

Para declarações normais de autor, uma camada posterior supera uma anterior, independentemente da especificidade entre camadas. Regras normais fora de todas as camadas superam todas as normais em camadas. Assim, um reset pode preceder componentes sem competir em especificidade. @import pode colocar uma folha inteira numa camada.

Com !important, a ordem inverte-se: camadas anteriores protegem declarações importantes, que também superam importantes sem camada. revert-layer recua apenas o vencedor da camada atual. O exemplo ordena reset antes de components, abre-as ao contrário e mostra componentes a vencer entre camadas e uma regra normal sem camada a vencer ambas.

Exemplos

const style = document.createElement('style');
style.textContent = `@layer reset, components;
@layer components { .probe { --layer-order: components; --origin: layered; } }
@layer reset { .probe { --layer-order: reset; } }
.probe { --origin: unlayered; }`;
document.head.append(style);
const probe = document.createElement('div');
probe.className = 'probe';
document.body.append(probe);
const computed = getComputedStyle(probe);
console.log('layer-order=' + computed.getPropertyValue('--layer-order').trim() + '; origin=' + computed.getPropertyValue('--origin').trim());

Resultado

layer-order=components; origin=unlayered

A regra @layer cria e ordena camadas de cascata, controlando a precedência de grupos de regras sem depender da especificidade.

Fontes