CKTIS / CSS
scroll-margin-left — Abstand links beim Scrollen zu einem Element
scroll-margin-left verschiebt die linke Kante des Bereichs, der beim Scrollen zum Ausrichten eines Elements verwendet wird. Es erzeugt keinen gewöhnlichen Layout-Abstand, sondern hilft dabei, links neben dem Ziel Platz zu lassen.
Version: 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;Ein positiver Wert für scroll-margin-left erweitert den Scroll-Snap-Bereich eines Elements nach links; ein negativer Wert verschiebt dessen linke Kante nach innen. Dieser Bereich geht vom Begrenzungsrechteck seiner transformierten Rahmenbox aus. Anders als margin-left verändert die Eigenschaft nicht das Layout.
Akzeptiert wird ein <length>, auch mit negativen Werten, aber weder ein Prozentsatz noch auto. Der Anfangswert ist 0; die Eigenschaft wird nicht vererbt. Sie bezieht sich auf die physische linke Seite; scroll-margin-inline-start hängt von der Schreibrichtung ab.
Setze sie am Zielelement und scroll-padding-left am Scroll-Container. Sie gilt auch beim Scrollen zu einem Fragment oder mit scrollIntoView(), selbst wenn kein Scroll-Snapping aktiviert ist. Scrollgrenzen können den Abstand einschränken.
Das Beispiel richtet das Ziel links aus und lässt dabei 24px Abstand. Ein Test mit Chromium 157.0.8103.51 in einer isolierten Umgebung bestätigte das erwartete Ergebnis: scrollLeft=176; gap=24px.
Beispiele
<!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>Ergebnis
scrollLeft=176; gap=24px
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.