z-index et contextes d'empilement comme ordre des calques dans Figma

Comment z-index et les contextes d'empilement CSS correspondent à l'ordre des calques dans Figma, ce qui crée un contexte et pourquoi 9999 peut perdre.

REFERENCEDEVELOPERPublié le

Introduction

Dans Figma, le z-index est l'ordre du panneau Layers : le calque du haut est au premier plan, celui du bas est à l'arrière. En CSS, c'est un entier, mais cet entier ne rivalise qu'à l'intérieur d'un contexte d'empilement (stacking context), donc un nombre plus grand ne gagne pas toujours. Cet article fait le lien entre les deux pour que vous puissiez lire l'ordre des calques d'une page importée et comprendre pourquoi une superposition se trouve là où elle est.

Il s'adresse aux designers qui héritent d'une page sous forme de calques et aux développeurs qui en transmettent une. Chaque fait provient de MDN ou des pages d'aide de Figma, à novembre 2026.

La version de Figma : le haut du panneau Layers est au premier plan

Figma n'a pas de champ z-index. L'aide de Figma explique que l'on règle la profondeur (axe Z) d'un calque en changeant son ordre dans le panneau Layers, et que la profondeur d'un calque correspond au z-index d'un objet. Le calque supérieur est au premier plan et le calque inférieur à l'arrière.

Vous changez l'ordre de trois façons :

  • Faites glisser le calque vers le haut dans le panneau Layers pour l'avancer, ou vers le bas pour le reculer.
  • Faites un clic droit et choisissez Bring forward, Bring to front, Send backward ou Send to back.
  • Utilisez les raccourcis clavier correspondant à ces quatre actions.

En dehors d'un cadre en auto layout, changer l'ordre des calques ne déplace pas le calque sur l'axe X ni sur l'axe Y. Cela change seulement ce qui recouvre quoi. C'est ce qui ressemble le plus, dans Figma, à un entier CSS : une place dans une liste, pas un nombre que l'on choisit.

À quels éléments z-index s'applique

Côté CSS, la référence z-index de MDN indique que la propriété s'applique aux éléments positionnés (tout position autre que static) et aux éléments flex et grid. Les éléments qui se chevauchent avec un z-index plus grand recouvrent ceux dont il est plus petit.

Deux valeurs comptent :

  • auto est la valeur initiale. La boîte ne crée pas de nouveau contexte d'empilement et son niveau dans le contexte courant est 0.
  • Un <integer> fixe le niveau de la boîte dans le contexte courant et fait aussi créer à la boîte un contexte d'empilement local. Les entiers négatifs placent l'élément derrière le contenu normal de son contexte.

Si deux éléments ont le même niveau, ils s'empilent dans l'ordre du DOM et le dernier est peint par-dessus. C'est pourquoi une page fonctionne souvent sans aucun entier. Pour la vue propriété par propriété de position, voyez CSS position in Figma.

L'ordre de peinture sans aucun z-index

Quand aucun élément ne définit z-index, la page MDN sur l'empilement sans z-index donne cet ordre, de bas en haut :

  1. L'arrière-plan et les bordures de l'élément racine.
  2. Les descendants non positionnés, dans l'ordre d'apparition dans le HTML.
  3. Les descendants positionnés, dans l'ordre d'apparition dans le HTML.

Un élément statique est donc dessiné sous un élément positionné, même s'il vient plus tard dans le balisage. MDN précise aussi que lorsque la propriété flex order modifie l'ordre de rendu, elle modifie de la même façon l'ordre d'empilement. "Ordre d'apparition" désigne l'ordre rendu, pas celui du code source.

Pour un designer, c'est la raison pour laquelle une infobulle en position: absolute recouvre une carte qui vient après elle dans le HTML. Personne n'a écrit de nombre. C'est la valeur de position qui a fait le travail.

Ce qui crée un contexte d'empilement

C'est ici que les ennuis commencent. La page MDN sur le contexte d'empilement liste ce qui en crée un. Les déclencheurs courants :

DéclencheurCrée un contexte quand
Élément racinetoujours
position: absolute ou relativez-index n'est pas auto
position: fixed ou stickytoujours
Élément flex ou gridz-index n'est pas auto
opacityinférieure à 1
mix-blend-modedifférent de normal
transform, filter, backdrop-filter, clip-path, maskdifférent de none
isolationisolate
containlayout ou paint

La liste comprend aussi container-type valant size ou inline-size, will-change nommant une propriété qui créerait un contexte, et les éléments de la couche supérieure (top layer). Concrètement : vous pouvez créer un contexte d'empilement sans jamais écrire de z-index. Une carte avec opacity: 0.9 ou un transform au survol en est déjà un.

Deux articles précédents couvrent les propriétés derrière plusieurs de ces lignes : opacity, blend modes, and filters et CSS transforms in Figma terms.

Les contextes d'empilement sont atomiques : pourquoi 9999 perd

MDN le formule ainsi : chaque contexte d'empilement est autonome, et une fois son contenu empilé, l'élément entier est traité comme une seule unité dans l'ordre d'empilement de son parent. Les valeurs de z-index des contextes enfants n'ont de sens qu'à l'intérieur du contexte du parent.

L'exemple de MDN le rend concret. Trois articles ont un z-index de 5, 2 et 4, et le troisième contient des sections à 6, 1 et 3. Chaque conteneur a opacity: 0.85, donc chacun est un contexte. La section au z-index 6 est rendue sous l'article au z-index 5, parce qu'elle appartient à l'article au z-index 4. MDN écrit les niveaux comme des numéros de version : 4-6 est inférieur à 5-0.

/* The section's 6 only counts inside #container3 (z-index: 4) */
#container1 { z-index: 5; }
#container3 { z-index: 4; }
#container4 { z-index: 6; }  /* child of #container3, still under #container1 */

Ainsi, une fenêtre modale avec z-index: 9999 perd contre un en-tête avec z-index: 10 si la modale se trouve dans un parent dont le contexte est plus bas. Augmenter le nombre n'y changera rien. Sortez la modale de là, ou changez le parent.

Dans Figma, vous voyez la même chose sous forme d'imbrication. Les enfants se trouvent sous leur cadre ou groupe parent dans le panneau Layers, et la place du parent dans la liste est celle où atterrit tout le groupe. Cet article ne prétend pas que les cadres Figma se comportent comme des groupes isolés dans tous les cas, car les pages d'aide de Figma ne le précisent pas. Prenez l'imbrication comme un indice et vérifiez sur le canevas.

Auto layout : l'ordre déplace les objets, le chevauchement demande une option

L'aide de Figma indique que l'ordre des calques fonctionne à l'inverse dans un cadre en auto layout. Changer l'ordre change la position du calque dans le cadre, parce que l'ordre est le flux. Dans un flux vertical, les objets que vous ajoutez, supprimez ou réordonnez suivent l'axe y ; dans un flux horizontal, l'axe x.

Pour faire chevaucher un élément dans un cadre en auto layout, activez Ignore auto layout. Le guide de l'auto layout de Figma précise que cette option s'appelait auparavant absolute position et que, comme l'absolute position en CSS, l'objet peut être placé précisément par rapport à son parent tout en restant dans le cadre. C'est l'équivalent Figma d'un enfant positionné dans un conteneur flex, et c'est là que vivent les superpositions, les pastilles et les boutons flottants.

Quoi vérifier après un import

UnHTML transforme une page en calques modifiables, pas en clone exact au pixel, et son rapport d'import liste ce qui est passé par une solution de repli. L'ordre des calques mérite une vérification manuelle :

  1. Sélectionnez chaque superposition : en-tête fixe, modale, menu déroulant, toast, pastille. Confirmez que chacune se trouve au-dessus du contenu qu'elle recouvre dans le panneau Layers.
  2. Cherchez un calque qui est "au-dessus" en CSS mais qui s'est retrouvé plus bas dans la liste. Un contexte parent, comme un opacity ou un transform sur un ancêtre, en est la cause habituelle.
  3. Dans les cadres en auto layout, vérifiez si un enfant qui chevauche est marqué Ignore auto layout. Sinon, le réordonner le déplacera au lieu de le ré-empiler.

Conclusion

Figma vous donne une liste ordonnée par parent, où le haut signifie le premier plan. CSS vous donne des entiers, l'ordre du DOM et des contextes imbriqués, et un contexte est décidé par de nombreuses propriétés en plus de z-index. Quand une pile CSS et une pile Figma ne concordent pas, trouvez d'abord l'ancêtre qui a créé le contexte, puis comparez l'ordre de ses frères.

Questions fréquentes

L'ordre des calques de Figma est-il identique au z-index CSS ?

L'aide de Figma elle-même indique que la profondeur d'un calque correspond au z-index d'un objet et que le calque du haut dans le panneau Layers est au premier plan. La correspondance se fait par l'ordre, pas par un nombre : Figma n'a pas de champ z-index, donc toute conversion doit transformer les entiers CSS en un ordre entre frères.

Pourquoi mon élément avec un z-index énorme reste-t-il derrière un autre ?

Le plus souvent parce qu'un parent crée un contexte d'empilement. Le z-index d'un enfant ne rivalise qu'à l'intérieur du contexte de son parent, et le parent compte comme une seule unité au niveau supérieur. Dans l'exemple de MDN, un enfant au z-index 6 est peint sous un élément à 5 pour cette raison précise.

L'opacity change-t-elle l'empilement en CSS ?

Oui. Une opacity inférieure à 1 crée un contexte d'empilement, tout comme transform, filter et isolation: isolate, même sans z-index défini.

Que vérifier à propos de z-index après l'import d'une page dans Figma ?

Considérez l'ordre du panneau Layers comme le résultat de l'ordre de peinture de la page. Vérifiez les éléments qui se chevauchent, comme les en-têtes fixes, les modales et les menus déroulants, et lisez le rapport d'import pour ce qui est passé par une solution de repli.