Formations — 1 037 leçons en français

Accueil › CSS & mise en page › z-index et contexte d'empilement

z-index et contexte d'empilement

Frameworks et débogageavance

La règle qui explique tous les z-index: 9999 qui ne marchent pas :

Un z-index n'est comparé qu'aux frères du même contexte d'empilement. Un enfant ne sort jamais du contexte de son parent.

<div style="position: relative; z-index: 1">   <!-- contexte A -->
  <div style="z-index: 9999">Je reste sous B</div>
</div>
<div style="position: relative; z-index: 2">B</div>

9999 est comparé aux frères dans A. A vaut 1, B vaut 2 : B gagne, toujours.

Ce qui crée un contexte — les quatre derniers sont ceux qui surprennent :

position: relative/absolute + z-index ≠ auto
position: fixed ou sticky
transform, opacity < 1, filter, will-change
isolation: isolate, contain: paint

L'échelle, pour ne plus improviser :

:root {
  --z-base: 0; --z-entete: 10; --z-dropdown: 100;
  --z-voile: 300; --z-modal: 400; --z-toast: 500;
}

Et la solution moderne qui supprime le problème : <dialog> et l'attribut popover placent l'élément dans le top layer, au-dessus de tout, sans aucun z-index.

Les termes à connaître

Contexte d'empilement

Un groupe isolé dans lequel les z-index sont comparés entre eux. Un enfant ne peut jamais sortir du contexte de son parent, quel que soit son z-index.

Créateurs de contexte

position + z-index, mais aussi transform, opacity < 1, filter, will-change, isolation: isolate, contain: paint. Les quatre derniers surprennent.

isolation: isolate

Crée un contexte d'empilement sans effet visuel. L'outil propre pour confiner les z-index d'un composant.

Échelle de z-index

Des valeurs nommées en variables CSS (--z-dropdown: 100, --z-modal: 400). Elle met fin à la surenchère de 9999.

Ordre de peinture

Sans z-index, les éléments positionnés sont peints dans l'ordre du document. Le dernier passe au-dessus — souvent la solution la plus simple.

@starting-style / popover

Les API modernes (popover, <dialog>, top-layer) placent un élément au-dessus de tout, sans aucun z-index à gérer.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.