CKTIS / CSS
scroll-margin-block-start — Scrollziel am Blockanfang versetzen
scroll-margin-block-start legt einen Versatz für den Bereich eines Scrollziels an dessen Blockanfangsseite fest. Es erzeugt keinen Abstand im Layout; welche physische Seite betroffen ist, hängt von writing-mode ab.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
scroll-margin-block-start: <length>;scroll-margin-block-start verändert den Scroll-Snap-Bereich eines Elements an dessen Blockanfangsseite. Bei horizontal-tb ist das oben, bei vertical-rl rechts. Anders als margin schafft die Eigenschaft keinen Abstand zwischen Elementen im Layout.
Zulässig ist ein <length>, auch ein negativer Längenwert, jedoch weder ein Prozentwert noch auto. Der Anfangswert ist 0; die Eigenschaft wird nicht vererbt. Lege sie am Zielelement fest, während scroll-padding-block-start zum Scrollcontainer gehört.
Dieser Bereich sollte bei der Fragmentnavigation und durch scrollIntoView() berücksichtigt werden, auch wenn kein Scroll-Snapping aktiviert ist. Der verfügbare Scrollbereich begrenzt den erreichbaren Abstand.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-block-start</title>
<style>
#scroller {
height: 160px;
overflow: auto;
writing-mode: horizontal-tb;
}
.space { height: 240px; }
#target {
height: 40px;
scroll-margin-block-start: 24px;
background: gold;
}
</style>
<button id="go">Scroll</button>
<div id="scroller">
<div class="space"></div>
<div id="target">Target</div>
<div class="space"></div>
</div>
<output id="result"></output>
<script>
const scroller = document.getElementById('scroller');
const target = document.getElementById('target');
document.getElementById('go').onclick = () => {
target.scrollIntoView({ block: 'start', behavior: 'instant' });
document.getElementById('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.