Règle CSSRègles @

@layer

Répartit les styles en couches de cascade d’ordre fixe. Une règle d’une couche ultérieure l’emporte quelle que soit la spécificité du sélecteur.

Sur cette page

Exemple

#
CSS
@layer reset, base, components, utilities;

@layer reset {
  button { margin: 0; border: 0; font: inherit; }
}

@layer base {
  a { color: #a78bfa; }
}

@layer components {
  button.btn {
    padding: 8px 16px;
    border-radius: 10px;
    background: #7c3aed;
    color: #fff;
  }
}

@layer utilities {
  .bg-rose { background: #f43f5e; }
}
Aperçu

La classe utilitaire .bg-rose l’emporte sur button.btn, bien qu’elle ait une spécificité plus faible, car la couche utilities est la dernière de la liste.

Définition et utilisation

#

La règle @layer organise la cascade. Vous enfermez les styles dans des couches nommées, et ce qui décide quelle déclaration l’emporte, c’est d’abord l’ordre des couches, puis seulement la spécificité du sélecteur et la position dans le code. Un sélecteur #menu .link d’une couche antérieure perd face à un simple a d’une couche ultérieure.

L’ordre est fixé par la première apparition d’un nom. Le plus pratique est de l’écrire une fois, au début de la feuille de style : @layer reset, base, components, utilities;. Ensuite, vous pouvez ajouter des styles aux couches n’importe où et dans n’importe quel ordre, même dans des fichiers distincts, par ex. via @import url("reset.css") layer(reset).

Les styles écrits en dehors de toute couche forment une couche implicite qui vient en dernier, donc ils l’emportent sur toutes les couches. C’est voulu : le code existant continue de fonctionner et vous pouvez introduire les couches progressivement. Avec !important, l’ordre s’inverse : une déclaration importante de la première couche l’emporte sur les déclarations importantes des couches suivantes.

Une organisation courante compte quatre couches : reset remet à zéro les styles par défaut du navigateur, base définit la typographie et l’apparence des éléments HTML ordinaires, components contient les boutons, cartes et formulaires, et utilities de petites classes utilitaires qui doivent toujours l’emporter. Tailwind CSS en version 4 applique un découpage semblable.

Syntaxe

#
Syntaxe
@layer reset, base, components;

@layer components {
  sélecteur { propriété: valeur; }
}

Comment les couches l’emportent

#
  • ordre des couches

    theme, vert

    La couche theme est la deuxième de la liste, elle l’emporte donc, même si son bloc se trouve plus haut dans le code que le bloc base.
  • sélecteur plus fort

    theme, vert

    Dans base se trouve un sélecteur avec un identifiant, et pourtant il perd. Les couches sont comparées avant la spécificité.
  • style sans couche

    style sans couche, ambre

    Une règle hors des couches l’emporte sur n’importe quelle couche, même si son sélecteur est plus faible et qu’elle se trouve plus tôt dans le code.
  • !important

    base, rouge

    Avec !important, l’ordre s’inverse : une déclaration importante d’une couche antérieure l’emporte sur une déclaration importante d’une couche ultérieure. Ainsi, un reset peut protéger des styles essentiels.
  • couches imbriquées

    components.buttons, bleu ciel

    Les couches peuvent être imbriquées, et vous désignez une couche interne avec un point. L’ordre compte alors à l’intérieur du groupe components.
  • revert-layer

    retour à base au survol

    Le mot-clé revert-layer ramène la valeur à celle des couches précédentes. Survolez le bouton : il revient au fond vert de la couche base.

Comment les couches l’emportent en pratique

#

ordre des couches

La couche theme est la deuxième de la liste, elle l’emporte donc, même si son bloc se trouve plus haut dans le code que le bloc base.
@layer base, theme;

@layer theme {
  .demo { background: #10b981; }
}

@layer base {
  .demo { background: #f43f5e; }
}

sélecteur plus fort

Dans base se trouve un sélecteur avec un identifiant, et pourtant il perd. Les couches sont comparées avant la spécificité.
@layer base, theme;

@layer base {
  #cta.demo { background: #f43f5e; }
}

@layer theme {
  .demo { background: #10b981; }
}

style sans couche

Une règle hors des couches l’emporte sur n’importe quelle couche, même si son sélecteur est plus faible et qu’elle se trouve plus tôt dans le code.
button { background: #f59e0b; }

@layer theme {
  #cta.demo { background: #10b981; }
}

!important

Avec !important, l’ordre s’inverse : une déclaration importante d’une couche antérieure l’emporte sur une déclaration importante d’une couche ultérieure. Ainsi, un reset peut protéger des styles essentiels.
@layer base, theme;

@layer base {
  .demo { background: #f43f5e !important; }
}

@layer theme {
  .demo { background: #10b981 !important; }
}

couches imbriquées

Les couches peuvent être imbriquées, et vous désignez une couche interne avec un point. L’ordre compte alors à l’intérieur du groupe components.
@layer components.base, components.buttons;

@layer components.buttons {
  .demo { background: #0ea5e9; }
}

@layer components.base {
  .demo { background: #f43f5e; }
}

revert-layer

Le mot-clé revert-layer ramène la valeur à celle des couches précédentes. Survolez le bouton : il revient au fond vert de la couche base.
@layer base, theme;

@layer base {
  .demo { background: #10b981; }
}

@layer theme {
  .demo { background: #f43f5e; }
  .demo:hover { background: revert-layer; }
}

Plus d’exemples

#
Le style d’une bibliothèque placée dans une couche perd face à votre code
CSS
@layer vendor, app;

@layer vendor {
  #widget .title { color: #f43f5e; }
}

@layer app {
  .title { color: #10b981; }
}
Aperçu

Le sélecteur de la bibliothèque contient un identifiant, et pourtant il perd, car la couche vendor vient plus tôt. En pratique, vous chargeriez la bibliothèque dans une couche avec @import url("lib.css") layer(vendor).

Compatibilité des navigateurs

#

Largement disponible · depuis 2022

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Écrivez l’ordre de toutes les couches sur une seule ligne, tout au début de la feuille de style. L’ordre est fixé par la première occurrence d’un nom, donc sans cette ligne il est facile de le modifier par accident.
  • N’oubliez pas que les styles hors des couches l’emportent sur les couches. En migrant un ancien code, commencez par le reset et les bibliothèques, et laissez pour l’instant vos propres styles hors des couches.
  • Les couches remplacent la course à la spécificité. Au lieu d’ajouter de nouvelles classes et !important, déplacez la règle dans une couche ultérieure.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.