CKTIS / CSS
scroll-margin-left — spazio a sinistra quando si scorre fino a un elemento
scroll-margin-left sposta il bordo sinistro dell’area usata per allineare un elemento durante lo scorrimento. Non crea un normale margine nel layout; aiuta a lasciare spazio a sinistra dell’elemento di destinazione.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
scroll-margin-left: <length>;
/* Examples */
scroll-margin-left: 24px;
scroll-margin-left: -8px;
scroll-margin-left: 0;Un valore positivo di scroll-margin-left estende verso sinistra l’area di snap allo scorrimento di un elemento; un valore negativo ne sposta il bordo sinistro verso l’interno. Quest’area parte dal rettangolo di delimitazione della sua border box trasformata. A differenza di margin-left, la proprietà non modifica il layout.
Accetta un <length>, anche con valori negativi, ma non percentuali né auto. Il valore iniziale è 0; la proprietà non è ereditata. Si riferisce al lato sinistro fisico; scroll-margin-inline-start dipende dalla direzione di scrittura.
Impostala sull’elemento di destinazione e imposta scroll-padding-left sul contenitore scorrevole. Si applica anche quando si scorre verso un frammento o tramite scrollIntoView(), senza che lo snap sia attivo. I limiti di scorrimento possono restringere lo spazio.
L’esempio allinea a sinistra l’elemento di destinazione lasciando 24px. Un test eseguito con Chromium 157.0.8103.51 in un ambiente isolato ha confermato il risultato atteso: scrollLeft=176; gap=24px.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-left</title>
<style>
#scroller {
width: 300px;
overflow-x: auto;
direction: ltr;
writing-mode: horizontal-tb;
}
.track { display: flex; width: 700px; }
.before { flex: 0 0 200px; }
#target {
flex: 0 0 100px;
height: 60px;
background: lightblue;
scroll-margin-left: 24px;
}
.after { flex: 0 0 400px; }
</style>
<div id="scroller">
<div class="track">
<div class="before"></div>
<div id="target">Target</div>
<div class="after"></div>
</div>
</div>
<pre id="result"></pre>
<script>
const scroller = document.getElementById('scroller');
const target = document.getElementById('target');
target.scrollIntoView({ behavior: 'instant', block: 'nearest', inline: 'start' });
requestAnimationFrame(() => {
const gap = target.getBoundingClientRect().left
- scroller.getBoundingClientRect().left;
document.getElementById('result').textContent =
`scrollLeft=${scroller.scrollLeft}; gap=${gap}px`;
});
</script>Risultato
scrollLeft=176; gap=24px
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.