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

CKTIS / CSS

scroll-padding-top — recuo superior da área visível durante o deslocamento

scroll-padding-top recua para dentro a margem superior da área de destino do deslocamento, sem acrescentar espaço ao esquema.

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

Sintaxe

scroll-padding-top: auto | <length-percentage [0,∞]>;

scroll-padding-top define um recuo interno superior para a área de visualização ideal de um contentor de deslocamento. Ao contrário de padding-top, não altera o esquema e também funciona sem ajuste do deslocamento.

Aceita auto ou um comprimento não negativo, ou uma percentagem da altura da área de deslocamento. Com o valor inicial auto, o navegador escolhe o valor, normalmente 0px. Não é herdada.

top designa sempre a margem superior física. scroll-padding-block-start refere-se à margem situada no início do eixo de bloco: a superior com writing-mode: horizontal-tb, a direita com writing-mode: vertical-rl e a esquerda com writing-mode: vertical-lr. Define scroll-padding-top no contentor e scroll-margin-top no destino. Para o deslocamento do documento, utiliza html, não body. O intervalo de deslocamento disponível limita a possibilidade de alcançar o recuo.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>scroll-padding-top</title>
<style>
  #scroller {
    height: 160px;
    overflow: auto;
    scroll-padding-top: 40px;
  }
  .space { height: 200px; }
  #target { height: 40px; 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>
<script>
  document.getElementById('go').onclick = () => {
    document.getElementById('target').scrollIntoView({
      block: 'start', inline: 'nearest', behavior: 'instant'
    });
  };
</script>

Resultado

After clicking Scroll: Target is 40 CSS px below the top of the scrollport; scroller.scrollTop is 160.

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