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

CKTIS / CSS

scroll-margin-block-start — deslocar um destino de deslocamento a partir do início do bloco

scroll-margin-block-start define um deslocamento para a área de um destino de deslocamento no lado do início do bloco. Não cria espaço no esquema; o lado físico afetado depende de writing-mode.

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

Sintaxe

scroll-margin-block-start: <length>;

scroll-margin-block-start modifica a área de ajuste ao deslocamento de um elemento no lado do início do bloco. Em horizontal-tb, esse lado é o superior; em vertical-rl, é o direito. Ao contrário de margin, não afasta elementos no esquema.

Aceita um <length>, incluindo valores negativos, mas não percentagens nem auto. O valor inicial é 0 e a propriedade não é herdada. Defina-a no elemento de destino; já scroll-padding-block-start pertence ao contentor de deslocamento.

Esta área deve ser tida em conta na navegação por fragmentos e por scrollIntoView(), mesmo sem o ajuste ao deslocamento ativado. O intervalo de deslocamento disponível limita o afastamento que é possível alcançar.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-block-start</title>
<style>
  #scroller {
    height: 160px;
    overflow: auto;
    writing-mode: horizontal-tb;
  }
  .space { height: 240px; }
  #target {
    height: 40px;
    scroll-margin-block-start: 24px;
    background: gold;
  }
</style>
<button id="go">Scroll</button>
<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');
  document.getElementById('go').onclick = () => {
    target.scrollIntoView({ block: 'start', behavior: 'instant' });
    document.getElementById('result').textContent =
      `scrollTop: ${scroller.scrollTop}`;
  };
</script>

Resultado

scrollTop: 216

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