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

CKTIS / CSS

scroll-margin-inline-start — margem de deslocação no início do eixo em linha

scroll-margin-inline-start especifica um deslocamento para a área-alvo de deslocação de um elemento no lado inline-start. Não acrescenta espaço à disposição dos elementos, e o lado físico depende da direção da escrita.

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

Sintaxe

scroll-margin-inline-start: <length>;

scroll-margin-inline-start desloca o limite inline-start da área de ajuste de deslocação de um elemento. Também afeta a deslocação até ao elemento quando o ajuste não está ativado. Ao contrário de margin-inline-start, não altera o esquema; já scroll-padding-inline-start é definido no contentor de deslocação.

Aceita um <length>, incluindo valores negativos, mas não percentagens nem auto. O valor inicial é 0 e a propriedade não é herdada. Um valor positivo expande a área-alvo desse lado.

Esta é uma direção lógica, não um limite esquerdo fixo: com writing-mode: horizontal-tb, inline-start fica à esquerda para direction: ltr e à direita para direction: rtl. Um modo de escrita vertical altera a correspondência dos eixos.

No exemplo, ao clicar em Scroll to B, deverão ficar 24 CSS px antes de B, sem alterar a disposição dos elementos. O valor esperado de scrollLeft é 176. O intervalo de deslocação disponível pode limitar o alinhamento pedido, sobretudo perto das extremidades do conteúdo.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-inline-start</title>
<style>
  .scroller {
    display: flex;
    width: 240px;
    overflow-x: auto;
    direction: ltr;
    writing-mode: horizontal-tb;
  }
  .item {
    flex: 0 0 200px;
    height: 80px;
    background: #ddd;
  }
  #target {
    scroll-margin-inline-start: 24px;
    background: #9df;
  }
</style>
<button id="go">Scroll to B</button>
<div class="scroller">
  <div class="item">A</div>
  <div class="item" id="target">B</div>
  <div class="item">C</div>
</div>
<script>
  document.getElementById('go').addEventListener('click', () => {
    document.getElementById('target').scrollIntoView({
      behavior: 'instant', block: 'nearest', inline: 'start'
    });
  });
</script>

Resultado

After clicking “Scroll to B”: scroller.scrollLeft = 176; B starts 24 CSS px inside the scroller's left edge.

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