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

CKTIS / CSS

scroll-padding-block-start — afastamento lógico da área visível de deslocamento

A propriedade scroll-padding-block-start recua o início da região de visualização ideal de um contentor com deslocamento. Ajuda a deixar espaço junto a um destino durante o deslocamento, sem adicionar padding normal.

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

Sintaxe

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

scroll-padding-block-start define um afastamento interno a partir da extremidade block-start de um contentor com deslocamento. A extremidade depende de writing-mode: é a superior com horizontal-tb e a direita com vertical-rl.

Aceita auto ou um comprimento não negativo, ou uma percentagem da dimensão correspondente da área de deslocamento. Com o valor inicial auto, o navegador escolhe, normalmente zero. A propriedade não é herdada.

Não altera a disposição dos elementos. No entanto, se o contentor estiver inicialmente numa posição de encaixe, alterar o afastamento em block-start pode deslocar essa posição ao mover a extremidade de alinhamento da área de encaixe (snapport). A propriedade define a região usada para deslocar o conteúdo até tornar visível o elemento de destino e para o alinhamento de encaixe. Não é necessário ativar o scroll snap para a usar. Defina-a no contentor, não no destino. Não é um padding normal.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>scroll-padding-block-start</title>
<style>
  #scroller {
    height: 160px;
    overflow: auto;
    writing-mode: horizontal-tb;
    scroll-padding-block-start: 40px;
  }
  .space { height: 200px; }
  #target { height: 40px; background: lightblue; }
</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: 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