WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

scroll-margin-inline-start — logischer Scrollabstand

scroll-margin-inline-start legt einen Versatz für den Scroll-Zielbereich eines Elements auf der Seite inline-start fest. Es erzeugt keinen Abstand im Layout; welche physische Seite gemeint ist, hängt von der Schreibrichtung ab.

Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

scroll-margin-inline-start: <length>;

scroll-margin-inline-start versetzt die inline-start-Kante des Scroll-Snap-Bereichs eines Elements. Es wirkt sich auch auf das Scrollen zu einem Element aus, wenn kein Scroll-Snap aktiviert ist. Anders als margin-inline-start verändert es das Layout nicht; scroll-padding-inline-start wird dagegen am Scroll-Container festgelegt.

Akzeptiert wird ein <length>, einschließlich negativer Werte, aber weder Prozentwerte noch auto. Der Anfangswert ist 0; die Eigenschaft wird nicht vererbt. Ein positiver Wert erweitert den Zielbereich auf dieser Seite.

Dies ist eine logische Richtung und keine festgelegte linke Kante: Bei writing-mode: horizontal-tb liegt inline-start für direction: ltr links und für direction: rtl rechts. Ein vertikaler Schreibmodus ändert die Zuordnung der Achsen.

Im Beispiel sollte nach einem Klick auf Scroll to B vor B ein Abstand von 24 CSS px verbleiben, ohne dass sich die Anordnung der Elemente ändert. Der erwartete Wert für scrollLeft ist 176. Der verfügbare Scrollbereich kann die gewünschte Ausrichtung einschränken, insbesondere nahe den Enden des Inhalts.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>scroll-margin-inline-start</title>
<style>
  .scroller {
    display: flex;
    width: 240px;
    overflow-x: auto;
    direction: ltr;
    writing-mode: horizontal-tb;
  }
  .item {
    flex: 0 0 200px;
    height: 80px;
    background: #ddd;
  }
  #target {
    scroll-margin-inline-start: 24px;
    background: #9df;
  }
</style>
<button id="go">Scroll to B</button>
<div class="scroller">
  <div class="item">A</div>
  <div class="item" id="target">B</div>
  <div class="item">C</div>
</div>
<script>
  document.getElementById('go').addEventListener('click', () => {
    document.getElementById('target').scrollIntoView({
      behavior: 'instant', block: 'nearest', inline: 'start'
    });
  });
</script>

Ergebnis

After clicking “Scroll to B”: scroller.scrollLeft = 176; B starts 24 CSS px inside the scroller's left edge.

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