CKTIS / CSS
z-index — ordem de sobreposição
A propriedade z-index define o nível de uma caixa dentro de um contexto de sobreposição. Números maiores colocam-na mais perto do observador, mas apenas dentro do mesmo contexto; um valor elevado não permite que um descendente escape ao contexto de sobreposição do seu antepassado.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
z-index: auto | <integer>;z-index controla a sobreposição de caixas posicionadas e de elementos flex e grid. Aceita auto ou um <integer>, incluindo valores negativos. O valor inicial é auto; a propriedade não é herdada. Frações e unidades de comprimento são inválidas.
Dentro do mesmo contexto de sobreposição, um nível mais elevado é desenhado à frente de um nível mais baixo. Um contexto filho é tratado como uma unidade: nem mesmo um z-index enorme num descendente o pode fazer escapar ao contexto do antepassado.
Para position: relative e position: absolute, auto significa nível zero sem que z-index crie um contexto; um número inteiro cria um contexto. Por isso, auto e 0 não são equivalentes. As caixas com position: fixed ou position: sticky criam um contexto mesmo com auto. Os elementos flex e grid com um valor diferente de auto criam um contexto mesmo com position: static.
No exemplo, #front cobre #back, apesar de surgir antes no documento. Se alterar o número não ajudar, verifica os contextos dos antepassados em vez de continuar a aumentar z-index.
Exemplos
<!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.
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.