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

CKTIS / CSS

scroll-margin-block — margem lógica de deslocamento

scroll-margin-block define margens no início e no fim do eixo do bloco em torno de um destino de deslocamento, sem alterar a disposição dos elementos.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate

Sintaxe

scroll-margin-block: <length>{1,2};

scroll-margin-block é uma forma abreviada de scroll-margin-block-start e scroll-margin-block-end. Um comprimento define ambos os lados; dois comprimentos especificam primeiro o início e depois o fim. Ambos têm inicialmente o valor 0; a propriedade não é herdada. As percentagens e auto não são válidos; são permitidos comprimentos negativos.

A direção do eixo depende de writing-mode: com horizontal-tb, refere-se ao topo e à base. A propriedade altera a área utilizada para o encaixe e para deslocar um destino até à área visível, não o espaçamento da disposição, como acontece com margin. Ao contrário de scroll-padding-block, aplica-se ao destino e não ao contentor.

O exemplo utiliza scrollIntoView() sem encaixe. O alinhamento start utiliza 24px; 8px diz respeito ao fim. Ao clicar no botão, é apresentado scrollTop: 216.

Exemplos

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