CKTIS / CSS
scroll-margin-left — ruimte links bij het scrollen naar een element
scroll-margin-left verschuift de linkerrand van het gebied dat wordt gebruikt om een element tijdens het scrollen uit te lijnen. Het maakt geen gewone lay-outmarge; het helpt ruimte links van het doel vrij te laten.
Versie: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
scroll-margin-left: <length>;
/* Examples */
scroll-margin-left: 24px;
scroll-margin-left: -8px;
scroll-margin-left: 0;Een positieve waarde voor scroll-margin-left breidt het scroll-snapgebied van een element naar links uit; een negatieve waarde verschuift de linkerrand van dat gebied naar binnen. Dat gebied gaat uit van de begrenzende rechthoek van de getransformeerde borderbox. Anders dan margin-left verandert deze eigenschap de lay-out niet.
De eigenschap accepteert een <length>, ook negatieve waarden, maar geen percentages of auto. De beginwaarde is 0; de eigenschap wordt niet overgeërfd. Ze geldt voor de fysieke linkerkant; scroll-margin-inline-start hangt af van de schrijfrichting.
Stel deze eigenschap in op het doelelement en scroll-padding-left op de scrollcontainer. Ze geldt ook bij het scrollen naar een fragment of met scrollIntoView(), zelfs als scroll snapping niet is ingeschakeld. Scrollgrenzen kunnen de ruimte beperken.
Het voorbeeld lijnt het doel links uit en laat 24px ruimte. Een test met Chromium 157.0.8103.51 in een geïsoleerde omgeving bevestigde het verwachte resultaat: scrollLeft=176; gap=24px.
Voorbeelden
<!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>Resultaat
scrollLeft=176; gap=24px
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.