WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

scroll-padding-block — den Zielbereich beim Scrollen versetzen

scroll-padding-block legt Versätze für den optimalen Anzeigebereich am Anfang und Ende der Blockachse eines Scrollcontainers 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-padding-block: [ auto | <length-percentage [0,∞]> ]{1,2};

scroll-padding-block ist die Kurzschreibweise für scroll-padding-block-start und scroll-padding-block-end. Ein Wert legt beide Seiten fest; zwei Werte geben zuerst Anfang und dann Ende an. Wende die Eigenschaft auf den Scrollcontainer an.

Zulässig sind nichtnegative Längen, Prozentwerte und auto (der Anfangswert, der vom Browser bestimmt wird). Prozentwerte beziehen sich auf die entsprechende Abmessung des Scrollports. Die Eigenschaft wird nicht vererbt.

Welche Seiten gemeint sind, hängt von writing-mode ab: Bei horizontal-tb sind es oben und unten, bei vertical-rl rechts und links. Gehe nicht davon aus, dass die Blockachse immer vertikal verläuft.

Diese Versätze erzeugen keinen zusätzlichen Platz wie padding und verändern das Layout nicht. Sie beeinflussen den Zielbereich beim Scrollen; beim Scroll-Snapping legen sie die Kanten des Snapports fest. Scroll-Snapping muss dafür nicht aktiviert sein.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>scroll-padding-block</title>
<style>
  #scroller {
    writing-mode: horizontal-tb;
    height: 160px;
    width: 240px;
    overflow: auto;
    scroll-padding-block: 24px 12px;
    border: 1px solid;
  }
  .space { height: 240px; }
  #target { height: 40px; background: lightblue; }
</style>
<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.getElementById('scroller');
  const target = document.getElementById('target');
  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.

Quellen