z-index y contextos de apilamiento como orden de capas en Figma
Cómo se traducen z-index y los contextos de apilamiento de CSS al orden de capas de Figma, qué crea un contexto y por qué un 9999 aún puede perder.
Introducción
En Figma, el z-index es el orden del panel Layers: la capa de arriba está al frente y la de abajo, al fondo. En CSS es un entero, pero ese entero solo compite dentro de un contexto de apilamiento (stacking context), así que un número mayor no siempre gana. Este artículo traslada uno al otro para que puedas leer el orden de capas de una página importada y entender por qué una superposición queda donde queda.
Está escrito para diseñadores que heredan una página como capas y para desarrolladores que entregan una. Todos los datos salen de MDN o de las páginas de ayuda de Figma, a noviembre de 2026.
La versión de Figma: lo de arriba del panel Layers está al frente
Figma no tiene un campo z-index. La ayuda de Figma explica que la profundidad (eje Z) de una capa se ajusta cambiando su orden en el panel Layers, y que la profundidad de una capa corresponde al z-index de un objeto. La capa superior está al frente y la inferior, al fondo.
El orden se cambia de tres maneras:
- Arrastra la capa hacia arriba en el panel Layers para traerla adelante, o hacia abajo para enviarla atrás.
- Haz clic derecho y elige Bring forward, Bring to front, Send backward o Send to back.
- Usa los atajos de teclado equivalentes para esas cuatro acciones.
Fuera de un marco con auto layout, cambiar el orden de capas no mueve la capa en el eje X ni en el Y. Solo cambia qué tapa a qué. Es lo más parecido que tiene Figma a un entero de CSS: un lugar en una lista, no un número que eliges.
A qué elementos se aplica z-index
Del lado de CSS, la referencia de z-index de MDN indica que la propiedad se aplica a elementos posicionados (cualquier position distinto de static) y a elementos flex y grid. Los elementos que se solapan con un z-index mayor cubren a los de uno menor.
Importan dos valores:
autoes el valor inicial. La caja no crea un nuevo contexto de apilamiento y su nivel en el contexto actual es 0.- Un
<integer>fija el nivel de la caja en el contexto actual y además hace que la caja cree un contexto de apilamiento local. Los enteros negativos colocan el elemento detrás del contenido normal de su contexto.
Si dos elementos comparten nivel, se apilan en orden del DOM y el último se pinta encima. Por eso una página suele funcionar sin ningún entero. Si quieres la vista propiedad por propiedad de position, consulta CSS position in Figma.
Orden de pintado sin z-index
Cuando ningún elemento define z-index, la página de MDN sobre apilamiento sin z-index da este orden, de abajo hacia arriba:
- El fondo y los bordes del elemento raíz.
- Los descendientes no posicionados, en orden de aparición en el HTML.
- Los descendientes posicionados, en orden de aparición en el HTML.
Así, un elemento estático se dibuja debajo de uno posicionado aunque venga después en el marcado. MDN también señala que cuando la propiedad flex order cambia el orden de renderizado, cambia igualmente el orden de apilamiento. "Orden de aparición" significa el orden renderizado, no el del código fuente.
Para un diseñador, por eso un tooltip con position: absolute cubre una tarjeta que viene después en el HTML. Nadie escribió un número. Lo hizo el valor de position.
Qué crea un contexto de apilamiento
Aquí empieza el problema. La página de MDN sobre contextos de apilamiento lista lo que crea uno. Los más comunes:
| Desencadenante | Crea un contexto cuando |
|---|---|
| Elemento raíz | siempre |
position: absolute o relative | z-index no es auto |
position: fixed o sticky | siempre |
| Elemento flex o grid | z-index no es auto |
opacity | menor que 1 |
mix-blend-mode | distinto de normal |
transform, filter, backdrop-filter, clip-path, mask | distinto de none |
isolation | isolate |
contain | layout o paint |
La lista también incluye container-type con valor size o inline-size, will-change que nombre una propiedad que crearía un contexto, y los elementos de la capa superior (top layer). Lo práctico: puedes crear un contexto de apilamiento sin escribir nunca un z-index. Una tarjeta con opacity: 0.9 o con un transform al pasar el cursor ya es uno.
Dos artículos anteriores cubren las propiedades detrás de varias de estas filas: opacity, blend modes, and filters y CSS transforms in Figma terms.
Los contextos son atómicos: por qué 9999 pierde
MDN lo resume así: cada contexto de apilamiento es autónomo, y una vez apilado su contenido, el elemento entero se trata como una sola unidad en el orden de apilamiento de su padre. Los valores de z-index de los contextos hijos solo tienen sentido dentro del contexto del padre.
El ejemplo de MDN lo vuelve concreto. Tres artículos tienen z-index 5, 2 y 4, y el tercero contiene secciones con 6, 1 y 3. Cada contenedor tiene opacity: 0.85, así que cada uno es un contexto. La sección con z-index 6 se renderiza debajo del artículo con z-index 5, porque pertenece al artículo con z-index 4. MDN escribe los niveles como números de versión: 4-6 es menor que 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 */
Así, un modal con z-index: 9999 pierde ante una cabecera con z-index: 10 si el modal vive dentro de un padre cuyo contexto está más abajo. Subir el número no ayuda. Saca el modal de ahí o cambia el padre.
En Figma ves lo mismo como anidamiento. Los hijos quedan bajo su marco o grupo padre en el panel Layers, y el lugar del padre en la lista es donde cae el grupo entero. Este artículo no afirma que los marcos de Figma se comporten como grupos aislados en todos los casos, porque las páginas de ayuda de Figma no lo especifican. Toma el anidamiento como una pista y comprueba el lienzo.
Auto layout: el orden mueve cosas, el solapamiento necesita un ajuste
La ayuda de Figma dice que el orden de capas funciona al revés dentro de un marco con auto layout. Cambiar el orden cambia la posición de la capa dentro del marco, porque el orden es el flujo. En un flujo vertical, los objetos que añades, quitas o reordenas siguen el eje y; en uno horizontal, el eje x.
Para solapar algo dentro de un marco con auto layout activas Ignore auto layout. La guía de auto layout de Figma indica que antes se llamaba absolute position y que, como la absolute position de CSS, el objeto se puede colocar con precisión respecto a su padre sin salir del marco. Es el equivalente en Figma de un hijo posicionado dentro de un contenedor flex, y ahí viven las superposiciones, las insignias y los botones flotantes.
Qué revisar tras una importación
UnHTML convierte una página en capas editables, no en un clon exacto al píxel, y su informe de importación lista lo que recurrió a un plan alternativo. El orden de capas conviene revisarlo a mano:
- Selecciona cada superposición: cabecera fija, modal, menú desplegable, toast, insignia. Confirma que cada una queda sobre el contenido que cubre en el panel Layers.
- Busca una capa que en CSS está "encima" pero quedó más abajo en la lista. Un contexto padre, como un
opacityo untransformen un ancestro, suele ser la causa. - En marcos con auto layout, comprueba si un hijo superpuesto tiene activado Ignore auto layout. Si no, reordenarlo lo moverá en lugar de reapilarlo.
Conclusión
Figma te da una lista ordenada por padre, donde lo de arriba está al frente. CSS te da enteros, orden del DOM y contextos anidados, y un contexto lo deciden muchas propiedades además de z-index. Cuando una pila de CSS y una de Figma no coinciden, busca primero el ancestro que creó el contexto y después compara el orden de sus hermanos.
Preguntas frecuentes
¿El orden de capas de Figma es lo mismo que el z-index de CSS?
La propia ayuda de Figma dice que la profundidad de una capa corresponde al z-index de un objeto y que la capa superior del panel Layers está al frente. La correspondencia es por orden, no por número: Figma no tiene campo z-index, así que cualquier conversión debe convertir los enteros de CSS en un orden entre hermanos.
¿Por qué mi elemento con un z-index enorme sigue detrás de otro?
Normalmente porque un padre crea un contexto de apilamiento. El z-index de un hijo solo compite dentro del contexto de su padre, y el padre cuenta como una unidad en el siguiente nivel. El ejemplo de MDN tiene un hijo con z-index 6 pintado bajo un elemento con 5 exactamente por esta razón.
¿La opacity cambia el apilamiento en CSS?
Sí. Una opacity menor que 1 crea un contexto de apilamiento, igual que transform, filter e isolation: isolate, incluso sin z-index.
¿Qué debo revisar sobre z-index tras importar una página en Figma?
Trata el orden del panel Layers como el resultado del orden de pintado de la página. Revisa los elementos que se solapan, como cabeceras fijas, modales y menús desplegables, y lee el informe de importación para ver lo que recurrió a un plan alternativo.