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

CKTIS / CSS

scroll-padding-inline-start — recuo no início inline da área de deslocamento

scroll-padding-inline-start define um recuo para dentro no limite inline-start da região de visualização ideal de um contentor de deslocamento. Não é um padding normal; o limite lógico depende da direção e do modo de escrita.

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

Sintaxe

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

scroll-padding-inline-start define um recuo para a região de alinhamento do deslocamento no lado inline-start. Aplica-se a um contentor de deslocamento, não é herdada e não acrescenta espaço ao esquema como faz padding.

Com writing-mode: horizontal-tb e direction: ltr, o início inline fica à esquerda; com direction: rtl, fica à direita. Num modo de escrita vertical, o eixo inline é vertical, pelo que não se deve equiparar inline-start ao lado esquerdo.

São aceites auto e comprimentos e percentagens não negativos. Uma percentagem refere-se à dimensão correspondente da área de deslocamento visível. O valor inicial auto deixa a escolha ao navegador e, em geral, significa 0px. Esta propriedade, por si só, não ativa o ajuste por snap; para isso, utiliza-se scroll-snap-type.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>scroll-padding-inline-start: inset for scroll alignment</title>
  <style>
    #scroller {
      display: flex;
      width: 300px;
      overflow-x: auto;
      writing-mode: horizontal-tb;
      direction: ltr;
      scroll-snap-type: x mandatory;
      scroll-padding-inline-start: 40px;
    }
    .card {
      flex: 0 0 200px;
      height: 80px;
      scroll-snap-align: start;
      background: #dcecff;
      outline: 1px solid #345;
      outline-offset: -1px;
    }
  </style>
</head>
<body>
  <div id="scroller" role="region" aria-label="Scrollable cards" tabindex="0">
    <div class="card">Card A</div>
    <div class="card" id="target">Card B</div>
    <div class="card">Card C</div>
  </div>
  <script>
    const scroller = document.getElementById('scroller');
    const target = document.getElementById('target');
    target.scrollIntoView({ behavior: 'instant', block: 'nearest', inline: 'start' });
    const inset = target.getBoundingClientRect().left - scroller.getBoundingClientRect().left;
    const style = getComputedStyle(scroller);
    console.log(`Computed inline-start scroll padding: ${style.scrollPaddingInlineStart}; ordinary inline-start padding: ${style.paddingInlineStart}`);
    console.log(`Card start inset: ${inset}px; scrollLeft: ${scroller.scrollLeft}px`);
  </script>
</body>
</html>

Resultado

Computed inline-start scroll padding: 40px; ordinary inline-start padding: 0px
Card start inset: 40px; scrollLeft: 160px

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