Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

z-index — ordine di sovrapposizione

La proprietà z-index stabilisce il livello di un riquadro all’interno di un contesto di sovrapposizione. I numeri più alti lo collocano più vicino all’osservatore, ma solo all’interno dello stesso contesto; un valore alto non permette a un discendente di uscire dal contesto di sovrapposizione dell’antenato.

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

Sintassi

z-index: auto | <integer>;

z-index controlla la sovrapposizione dei riquadri posizionati e degli elementi flex e grid. Accetta auto o un <integer>, compresi i valori negativi. Il valore iniziale è auto; la proprietà non è ereditata. Le frazioni e le unità di lunghezza non sono valide.

All’interno dello stesso contesto di sovrapposizione, un livello più alto viene disegnato davanti a uno più basso. Un contesto figlio viene trattato come un’unica unità: nemmeno un z-index enorme di un discendente può farlo uscire dal contesto dell’antenato.

Per position: relative e position: absolute, auto indica il livello zero senza che z-index crei un contesto; un numero intero lo crea. Quindi auto e 0 non sono equivalenti. I riquadri con position: fixed o position: sticky creano un contesto anche con auto. Gli elementi flex e grid con un valore diverso da auto creano un contesto anche con position: static.

Nell’esempio, #front copre #back nonostante compaia prima nel documento. Se modificare il numero non serve, controlla i contesti degli antenati invece di continuare ad aumentare z-index.

Esempi

<!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>

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti