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

CKTIS / CSS

top — deslocamento superior

A propriedade `top` especifica o deslocamento superior de um elemento posicionado. O seu significado depende de `position`; não tem efeito com `static`.

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

Sintaxe

top: auto | <length-percentage>;

For an absolutely positioned element (including `position: fixed`), the `<length-percentage>` value can use `anchor()` or `anchor-size()`, subject to the rules of CSS Anchor Positioning.

top refere-se ao topo físico. Não é herdada; o valor inicial auto não significa simplesmente zero. São permitidos comprimentos, percentagens e valores negativos.

Com relative, desloca o elemento em relação à sua posição original, sem alterar o espaço que lhe está reservado. Com absolute e fixed, especifica um deslocamento em relação ao bloco de contenção; com fixed, esse bloco é normalmente a área de visualização, mas nem sempre.

Com sticky, define um limite superior em relação à área de deslocação visível mais próxima, sem que o elemento saia do bloco de contenção. As percentagens são calculadas com base na altura do bloco de contenção ou, com sticky, na altura da área de deslocação visível.

No exemplo, top: 25% dá 30px porque o contentor tem 120px de altura. Com position: static, a propriedade não tem efeito.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>top</title>
<style>
  .container {
    position: relative;
    width: 200px;
    height: 120px;
    background: #eee;
  }
  .box {
    position: absolute;
    top: 25%;
    left: 0;
    width: 40px;
    height: 40px;
    margin: 0;
    background: #1565c0;
  }
</style>
<div class="container"><div class="box"></div></div>

Resultado

box top − container top = 30 CSS px

O código apresentado e o resultado declarado foram verificados num ambiente isolado, segundo o método registado na prova de verificação desta versão exata.

Fontes