WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

scroll-margin — Abstand beim Scrollen zu einem Element

scroll-margin legt Abstände um ein Element fest, die beim Scrollen zu diesem Element und beim Scroll-Snap berücksichtigt werden, ohne den Layoutabstand 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: <length>{1,4};

scroll-margin erweitert den Snap-Bereich ausgehend vom Begrenzungsrechteck des transformierten Rahmenkastens eines Elements. Anders als margin erzeugt es keinen Abstand im Layout. Lege die Eigenschaft am Zielelement fest; scroll-padding gehört zum scrollbaren Container.

Die Eigenschaft akzeptiert 1 bis 4 Längen: alle Seiten; oben/unten und links/rechts; oben, links/rechts, unten; oben, rechts, unten, links. Negative Werte sind zulässig, Prozentwerte und auto jedoch nicht. Der Anfangswert ist 0; die Eigenschaft wird nicht vererbt.

Sie wirkt sich auch auf die Fragmentnavigation und auf scrollIntoView() aus, wenn Scroll-Snap nicht aktiviert ist. Sie aktiviert Scroll-Snap nicht selbst. Scrollgrenzen können verhindern, dass der gewünschte Abstand eingehalten wird.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>scroll-margin example</title>
<style>
  #scroller { height: 120px; overflow: auto; }
  .spacer { height: 200px; }
  #target { height: 40px; scroll-margin: 24px 0 0; background: gold; }
</style>
<button type="button" id="show">Show target</button>
<div id="scroller">
  <div class="spacer"></div>
  <div id="target">Target</div>
  <div class="spacer"></div>
</div>
<pre id="result"></pre>
<script>
  const scroller = document.getElementById('scroller');
  const target = document.getElementById('target');
  document.getElementById('show').addEventListener('click', () => {
    target.scrollIntoView({ block: 'start', behavior: 'instant' });
    document.getElementById('result').textContent =
      `scrollTop: ${scroller.scrollTop}`;
  });
</script>
</html>

Ergebnis

scrollTop: 176

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.

Quellen