Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

scroll-margin-inline-start — offset logico dello scorrimento

scroll-margin-inline-start specifica un offset per l’area di destinazione dello scorrimento di un elemento sul lato inline-start. Non crea spazio nel layout e il lato fisico dipende dalla direzione di scrittura.

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

Sintassi

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

scroll-margin-inline-start sposta il bordo inline-start dell’area di snap allo scorrimento di un elemento. Influisce anche sullo scorrimento fino all’elemento quando lo snap non è attivo. A differenza di margin-inline-start, non modifica il layout; scroll-padding-inline-start, invece, si imposta sul contenitore di scorrimento.

Accetta un <length>, anche con valori negativi, ma non percentuali né auto. Il valore iniziale è 0 e la proprietà non è ereditata. Un valore positivo estende l’area di destinazione su quel lato.

È una direzione logica, non un bordo sinistro fisso: con writing-mode: horizontal-tb, inline-start è a sinistra per direction: ltr e a destra per direction: rtl. Una modalità di scrittura verticale cambia la corrispondenza degli assi.

Nell’esempio, facendo clic su Scroll to B dovrebbero rimanere 24 CSS px prima di B, senza modificare la disposizione degli elementi. Il valore previsto di scrollLeft è 176. L’intervallo di scorrimento disponibile può limitare l’allineamento richiesto, soprattutto vicino alle estremità del contenuto.

Esempi

<!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>

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti