CKTIS / CSS
scroll-timeline — eine benannte Scroll-Fortschrittszeitleiste
Die Kurzschreibweise scroll-timeline definiert eine benannte Zeitleiste für einen Scroll-Container. Eine Animation, die diese Zeitleiste verwendet, schreitet entsprechend der Scrollposition statt anhand der verstrichenen Zeit voran.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
scroll-timeline: [ <'scroll-timeline-name'> <'scroll-timeline-axis'>? ]#;scroll-timeline kombiniert scroll-timeline-name und scroll-timeline-axis. Namen beginnen mit --; none definiert keine benannte Zeitleiste. Wird die Achse weggelassen, gilt block. Kommas trennen mehrere Definitionen. Die Eigenschaft wird weder vererbt noch ist sie animierbar.
block und inline hängen vom Schreibmodus ab; x und y bezeichnen physische Achsen. Gibt es auf der ausgewählten Achse keinen Scrollbereich, ist die Zeitleiste inaktiv. Der Fortschritt richtet sich nach der Position über den gesamten Scrollbereich und nicht nach der Sichtbarkeit eines Elements.
Die Deklaration allein startet keine Animation. Im Beispiel wählt ein Nachfahre --progress über animation-timeline aus. Platziere diese Deklaration nach animation, da die Kurzschreibweise die Zeitleistenauswahl zurücksetzt. Rückwärts zu scrollen kehrt den Effekt um. Genau diese Version des Beispiels hat eine strukturelle Prüfung in einem isolierten Browser bestanden. Das bestätigt jedoch nicht, dass die Balkenbreite an jeder angegebenen Scrollposition gemessen wurde. Prüfe das Verhalten vor der Bereitstellung im Zielbrowser.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>scroll-timeline</title>
<style>
.scroller {
width: 240px;
height: 160px;
overflow: auto;
scroll-timeline: --progress block;
}
.content { height: 640px; }
.bar {
position: sticky;
top: 0;
height: 12px;
background: teal;
transform-origin: left;
animation: fill linear both;
animation-timeline: --progress;
}
@keyframes fill {
from { transform: scaleX(0); }
to { transform: scaleX(1); }
}
</style>
<div class="scroller" tabindex="0" aria-label="Scroll demo">
<div class="content"><div class="bar"></div></div>
</div>Ergebnis
Expected visual result: the teal bar has zero width at scrollTop 0, half width at scrollTop 240, and full width at scrollTop 480. Scrolling backward reverses the change.
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.