Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

z-index — orden de apilamiento

La propiedad z-index establece el nivel de una caja dentro de un contexto de apilamiento. Los números más altos la sitúan más cerca del espectador, pero solo dentro del mismo contexto; un valor alto no permite que un descendiente escape del contexto de apilamiento de su antecesor.

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

Sintaxis

z-index: auto | <integer>;

z-index controla la superposición de cajas posicionadas y de elementos flex y grid. Acepta auto o un <integer>, incluidos los valores negativos. Su valor inicial es auto; no se hereda. Las fracciones y las unidades de longitud no son válidas.

Dentro del mismo contexto de apilamiento, un nivel más alto se pinta delante de uno más bajo. Un contexto hijo se trata como una unidad: ni siquiera un z-index enorme en un descendiente puede hacer que escape del contexto de su antecesor.

Para position: relative y position: absolute, auto significa nivel cero sin que z-index cree un contexto; un entero sí lo crea. Por tanto, auto y 0 no son equivalentes. Las cajas con position: fixed o position: sticky crean un contexto incluso con auto. Los elementos flex y grid con un valor distinto de auto crean un contexto incluso con position: static.

En el ejemplo, #front cubre a #back a pesar de aparecer antes en el documento. Si cambiar el número no ayuda, revisa los contextos de los antecesores en lugar de seguir aumentando z-index.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>z-index</title>
<style>
  .stage {
    position: relative;
    z-index: 0;
    width: 200px;
    height: 140px;
  }
  .box {
    position: absolute;
    width: 120px;
    height: 80px;
    color: black;
  }
  #front {
    top: 0;
    left: 0;
    background: orange;
    z-index: 2;
  }
  #back {
    top: 40px;
    left: 60px;
    background: lightblue;
    z-index: 1;
  }
</style>
<div class="stage">
  <div class="box" id="front">FRONT</div>
  <div class="box" id="back">BACK</div>
</div>
</html>

Resultado

FRONT (orange) overlaps BACK (lightblue). No console output.

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes