CKTIS / CSS
scroll-margin-block – logischer Scroll-Abstand
scroll-margin-block legt Abstände am Anfang und Ende der Blockachse um ein Scrollziel fest, ohne das Layout der Elemente zu verändern.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate
Syntax
scroll-margin-block: <length>{1,2};scroll-margin-block ist die Kurzschreibweise für scroll-margin-block-start und scroll-margin-block-end. Ein Längenwert legt beide Seiten fest; zwei Werte geben zuerst den Anfang und dann das Ende an. Beide Werte sind anfänglich 0; die Eigenschaft wird nicht vererbt. Prozentwerte und auto sind ungültig; negative Längen sind zulässig.
Die Richtung der Achse richtet sich nach writing-mode: Bei horizontal-tb sind damit oben und unten gemeint. Die Eigenschaft verändert den Bereich, der zum Einrasten und zum Scrollen eines Ziels in den sichtbaren Bereich verwendet wird, nicht aber den Layoutabstand wie margin. Anders als scroll-padding-block wird sie am Ziel und nicht am Container festgelegt.
Das Beispiel verwendet scrollIntoView() ohne Einrasten. Die Ausrichtung start nutzt 24px; 8px gilt für das Ende. Nach einem Klick auf die Schaltfläche zeigt das Beispiel scrollTop: 216 an.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-block</title>
<style>
#scroller {
height: 160px;
overflow: auto;
writing-mode: horizontal-tb;
}
.space { height: 240px; }
#target {
height: 40px;
background: gold;
scroll-margin-block: 24px 8px;
}
</style>
<button type="button" id="go">Scroll</button>
<div id="scroller">
<div class="space"></div>
<div id="target">Target</div>
<div class="space"></div>
</div>
<pre id="result"></pre>
<script>
const scroller = document.querySelector('#scroller');
const target = document.querySelector('#target');
document.querySelector('#go').addEventListener('click', () => {
target.scrollIntoView({ block: 'start', behavior: 'instant' });
document.querySelector('#result').textContent =
`scrollTop: ${scroller.scrollTop}`;
});
</script>Ergebnis
scrollTop: 216
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.