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

CKTIS / CSS

scroll-margin — espaçamento ao deslocar até um elemento

scroll-margin define afastamentos à volta de um elemento que são considerados ao deslocar até ele e no ajuste do deslocamento, sem alterar o espaçamento do esquema.

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

Sintaxe

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

scroll-margin expande a área de ajuste a partir do retângulo delimitador da caixa de borda transformada de um elemento. Não cria espaçamento no esquema como margin. Defina-a no elemento de destino; scroll-padding aplica-se ao contentor com deslocamento.

Aceita de 1 a 4 comprimentos: todos os lados; cima/baixo e esquerda/direita; cima, esquerda/direita, baixo; cima, direita, baixo, esquerda. São permitidos valores negativos, mas não percentagens nem auto. O valor inicial é 0 e a propriedade não é herdada.

Também afeta a navegação por fragmentos e scrollIntoView() quando o ajuste do deslocamento não está ativado. Não ativa o ajuste por si só. Os limites de deslocamento podem impedir que o espaçamento pedido seja mantido.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>scroll-margin example</title>
<style>
  #scroller { height: 120px; overflow: auto; }
  .spacer { height: 200px; }
  #target { height: 40px; scroll-margin: 24px 0 0; background: gold; }
</style>
<button type="button" id="show">Show target</button>
<div id="scroller">
  <div class="spacer"></div>
  <div id="target">Target</div>
  <div class="spacer"></div>
</div>
<pre id="result"></pre>
<script>
  const scroller = document.getElementById('scroller');
  const target = document.getElementById('target');
  document.getElementById('show').addEventListener('click', () => {
    target.scrollIntoView({ block: 'start', behavior: 'instant' });
    document.getElementById('result').textContent =
      `scrollTop: ${scroller.scrollTop}`;
  });
</script>
</html>

Resultado

scrollTop: 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