KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

scroll-timeline — een benoemde tijdlijn voor scrollvoortgang

De verkorte eigenschap scroll-timeline definieert een benoemde tijdlijn op een scrollcontainer. Een animatie die deze tijdlijn gebruikt, vordert op basis van de scrollpositie in plaats van de verstreken tijd.

Versie: 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 combineert scroll-timeline-name en scroll-timeline-axis. Namen beginnen met --; none definieert geen benoemde tijdlijn. Als de as wordt weggelaten, geldt block. Komma’s scheiden meerdere definities. De eigenschap wordt niet overgeërfd en is niet animeerbaar.

block en inline zijn afhankelijk van de schrijfmodus; x en y duiden fysieke assen aan. Zonder scrollbereik op de geselecteerde as is de tijdlijn inactief. De voortgang volgt de positie over het volledige scrollbereik, niet de zichtbaarheid van een element.

De declaratie alleen start geen animatie. In het voorbeeld selecteert een afstammeling --progress via animation-timeline. Plaats die declaratie na animation, omdat de verkorte eigenschap de tijdlijnselectie opnieuw instelt. Achteruit scrollen keert het effect om. De structuur van precies deze versie van het voorbeeld is gecontroleerd in een geïsoleerde browser. Dat bevestigt niet dat de breedte van de balk op elke genoemde scrollpositie is gemeten. Controleer het gedrag in de doelbrowser voordat je dit implementeert.

Voorbeelden

<!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>

Resultaat

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.

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen