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

CKTIS / CSS

scroll-margin-top — margem superior ao deslocar

scroll-margin-top define a extensão superior da área de um elemento utilizada para o deslocar até à área visível e para o encaixe do deslocamento. Não cria espaço no esquema da página.

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

Sintaxe

scroll-margin-top: <length>;

scroll-margin-top expande para cima a área de encaixe do deslocamento de um elemento. Refere-se ao topo físico; scroll-margin-block-start refere-se ao início do eixo de bloco, de acordo com o modo de escrita.

Aceita um valor <length>, incluindo valores negativos, mas não percentagens nem auto. O valor inicial é 0; não é herdada e aplica-se a todos os elementos.

Define-a no destino do deslocamento, por exemplo, para deixar espaço por baixo de um cabeçalho fixo. Ao contrário de margin-top, não altera o esquema. scroll-padding-top define o espaço do lado do contentor. Ao deslocar até um destino, esta área é tida em conta mesmo sem o encaixe estar ativo; os limites do deslocamento podem restringir o espaço resultante.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-top</title>
<style>
  #scroller { height: 120px; overflow: auto; scroll-behavior: auto; }
  .space { height: 200px; }
  #target { height: 40px; scroll-margin-top: 24px; background: gold; }
</style>
<div id="scroller">
  <div class="space"></div>
  <div id="target">Target</div>
  <div class="space"></div>
</div>
<output id="result"></output>
<script>
  const scroller = document.getElementById('scroller');
  const target = document.getElementById('target');
  target.scrollIntoView({ block: 'start', behavior: 'instant' });
  document.getElementById('result').textContent = scroller.scrollTop;
</script>

Resultado

176

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