CKTIS / CSS
scroll-padding-block-start — logischer Abstand im sichtbaren Scrollbereich
Die Eigenschaft scroll-padding-block-start rückt den Anfang des optimalen Sichtbereichs eines Scrollcontainers nach innen. So bleibt beim Scrollen zu einem Ziel Platz, ohne gewöhnliches Padding hinzuzufügen.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
scroll-padding-block-start: auto | <length-percentage [0,∞]>;scroll-padding-block-start legt einen inneren Abstand von der block-start-Kante eines Scrollcontainers fest. Welche Kante das ist, hängt von writing-mode ab: Bei horizontal-tb ist es die obere, bei vertical-rl die rechte Kante.
Zulässig sind auto oder eine nichtnegative Länge beziehungsweise ein Prozentsatz der entsprechenden Scrollport-Abmessung. Beim anfänglichen Wert auto entscheidet der Browser, meist mit dem Ergebnis null. Die Eigenschaft wird nicht vererbt.
Sie verändert das Layout nicht. Befindet sich der Container anfangs jedoch an einer Snap-Position, kann sich diese Position ändern, wenn der Abstand an block-start geändert wird: Dadurch verschiebt sich die Kante des Snapports, an der ausgerichtet wird. Die Eigenschaft legt den Bereich fest, der beim Scrollen eines Ziels in den sichtbaren Bereich und bei der Snap-Ausrichtung verwendet wird. Sie lässt sich auch ohne aktiviertes Scroll Snap verwenden. Setze die Eigenschaft auf den Container, nicht auf das Ziel. Sie ist kein gewöhnliches padding.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>scroll-padding-block-start</title>
<style>
#scroller {
height: 160px;
overflow: auto;
writing-mode: horizontal-tb;
scroll-padding-block-start: 40px;
}
.space { height: 200px; }
#target { height: 40px; background: lightblue; }
</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: 160
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.