Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

@layer — livelli di cascata

La regola @layer crea e ordina livelli di cascata per controllare la precedenza di gruppi di regole indipendentemente dalla specificità.

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

Sintassi

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

@layer <layer-name-list>; stabilisce l’ordine dei nomi, mentre @layer <name> { <stylesheet> } inserisce regole in un livello. La prima dichiarazione d’ordine conta; riaprire un livello aggiunge regole senza spostarlo. I livelli anonimi hanno posizione stabile ma non si riaprono per nome. Possono annidarsi e usare nomi puntati.

Per dichiarazioni autore normali, un livello successivo supera uno precedente indipendentemente dalla specificità tra livelli. Regole autore normali fuori da ogni livello superano tutte le normali nei livelli. Un reset può quindi precedere i componenti senza gara di specificità. @import può inserire un intero foglio in un livello.

Con !important l’ordine si inverte: i livelli precedenti proteggono le dichiarazioni importanti, che superano anche quelle importanti fuori livello. revert-layer annulla solo il vincitore del livello corrente. L’esempio ordina reset prima di components, li apre al contrario e mostra entrambe le precedenze.

Esempi

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());

Risultato

layer-order=components; origin=unlayered

La regola @layer crea e ordina livelli di cascata per controllare la precedenza di gruppi di regole indipendentemente dalla specificità.

Fonti