WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

@layer — Kaskadenebenen

Die Regel @layer erzeugt und ordnet Kaskadenebenen und steuert so den Vorrang von Regelgruppen unabhängig von Selektorspezifität.

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

Syntax

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

@layer <layer-name-list>; legt die Namensreihenfolge fest, @layer <name> { <stylesheet> } fügt Regeln ein. Die erste Reihenfolge ist maßgeblich; erneutes Öffnen hängt Regeln an, ohne die Ebene zu verschieben. Anonyme Ebenen haben eine feste Position, lassen sich aber nicht per Name öffnen. Ebenen können verschachtelt und mit Punktnamen adressiert werden.

Bei normalen Autorendeklarationen gewinnt eine spätere Ebene gegen eine frühere, unabhängig von Spezifität zwischen Ebenen. Normale Autorregeln außerhalb aller Ebenen gewinnen gegen alle normalen Ebenenregeln. So kann ein Reset vor Komponenten liegen, ohne Spezifitätskampf. @import kann ein ganzes Sheet einer Ebene zuweisen.

Bei !important kehrt sich die Reihenfolge um: Frühere Ebenen schützen wichtige Regeln; wichtige Ebenenregeln gewinnen gegen wichtige Regeln außerhalb. revert-layer nimmt nur den Gewinner der aktuellen Ebene zurück. Das Beispiel ordnet reset vor components, öffnet sie umgekehrt und zeigt den Komponentensieg innerhalb der Ebenen sowie den Sieg einer normalen Regel außerhalb.

Beispiele

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

Ergebnis

layer-order=components; origin=unlayered

Die Regel @layer erzeugt und ordnet Kaskadenebenen und steuert so den Vorrang von Regelgruppen unabhängig von Selektorspezifität.

Quellen