CKTIS / CSS
scroll-margin-inline — logische Scroll-Abstände
Diese Kurzschreibweise legt Abstände des Zielbereichs am Anfang und Ende der Inline-Achse fest, ohne das Layout der Elemente zu verändern.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
scroll-margin-inline: <length>{1,2};scroll-margin-inline legt für das Zielelement scroll-margin-inline-start und scroll-margin-inline-end fest. Ein Längenwert gilt für beide Seiten; zwei Werte geben zuerst Anfang und dann Ende an. Der Anfangswert ist 0; die Eigenschaft wird nicht vererbt. Prozentwerte und auto sind ungültig; negative Längen sind zulässig.
Die logischen Seiten hängen von writing-mode und direction ab und bedeuten nicht immer links und rechts. Die Abstände verändern den Bereich für Scroll-Snap und das Scrollen zum Element, nicht dessen Größe oder Abstände im Layout. scroll-padding-inline wirkt dagegen auf den Scroll-Container.
Die Eigenschaft aktiviert Scroll-Snap nicht selbst: Dafür dienen scroll-snap-type und scroll-snap-align. Sie kann auch das Scrollen zum Element ohne Scroll-Snap beeinflussen. Scrollgrenzen können verhindern, dass der gesamte Abstand berücksichtigt wird.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>scroll-margin-inline: inline snap offsets</title>
<style>
#track {
display: flex;
width: 300px;
overflow-x: auto;
writing-mode: horizontal-tb;
direction: ltr;
scroll-snap-type: x mandatory;
}
#track > div {
flex: 0 0 200px;
height: 80px;
margin: 0;
scroll-snap-align: start;
background: lightblue;
}
#track > #target {
scroll-margin-inline: 20px 40px;
background: coral;
}
</style>
</head>
<body>
<div id="track" role="region" aria-label="Scrollable cards" tabindex="0">
<div>Card A</div><div id="target">Card B</div><div>Card C</div>
</div>
<script>
const track = document.getElementById('track');
const target = document.getElementById('target');
const style = getComputedStyle(target);
target.scrollIntoView({ behavior: 'instant', block: 'nearest', inline: 'start' });
const card = target.getBoundingClientRect();
const inset = card.left - track.getBoundingClientRect().left;
console.log(`Computed inline scroll margins: ${style.scrollMarginInlineStart} / ${style.scrollMarginInlineEnd}`);
console.log(`Card width: ${card.width}px; card start inset: ${inset}px`);
</script>
</body>
</html>Ergebnis
Computed inline scroll margins: 20px / 40px Card width: 200px; card start inset: 20px
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.