Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes