KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

WAAPI: keyframe-arrays en timingopties

Geef een array met keyframes door aan `Element.animate()` en stel in een apart optieobject in hoe lang een iteratie duurt, hoe die verloopt en hoe vaak die wordt uitgevoerd.

Versie: Current web platform; runtime support varies

Syntax

element.animate(keyframes, { duration, easing, iterations })
element.animate(keyframes, duration)

element.animate(keyframes, options) maakt een animatie voor een DOM-element, start die en geeft het Animation-object terug. De methode en de timingopties horen bij de Web Animations API (WAAPI), niet bij ECMAScript 2024 of een andere ECMAScript-editie. De beschikbaarheid hangt af van de uitvoeromgeving.

In een keyframe-array geeft elk object op één punt in een iteratie waarden op voor animeerbare CSS-eigenschappen zoals opacity. offset plaatst dat punt tussen 0 en 1, inclusief. Expliciete offsets moeten in niet-afnemende volgorde staan. Ontbrekende offsets worden gelijkmatig verdeeld: drie keyframes zonder offsets krijgen 0, 0.5 en 1. Eén object met arrays van waarden per eigenschap, zoals { opacity: [0, 1] }, is een ander ondersteund formaat.

In de opties geeft een numerieke duration de duur van één iteratie in milliseconden aan. Een getal als tweede argument is een verkorte manier om alleen duration in te stellen. iterations is het totale aantal iteraties: standaard 1, 2.5 voor twee volledige iteraties en de helft van een derde, en de numerieke waarde Infinity voor geen eindige limiet. Bij een positieve, eindige duur en een eindig aantal iteraties is de actieve duur duration * iterations, zonder vertragingen.

easing in het optieobject is een CSS-functie voor het verloop, geschreven als tekenreeks, met "linear" als standaard. Die verandert het verloop over de hele iteratie, niet de duur ervan. easing in een keyframe geldt vanaf dat keyframe tot het volgende; beide instellingen kunnen samenwerken.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>WAAPI keyframes and timing</title>
<script>
  (() => {
    const element = document.createElement("div");
    const keyframes = [
      { opacity: 0 },
      { opacity: 1, easing: "ease-in" },
      { opacity: 0 },
    ];
    const animation = element.animate(keyframes, {
      duration: 600,
      easing: "ease-in-out",
      iterations: 2.5,
    });

    const effect = animation.effect;
    const { duration, easing, iterations, activeDuration } = effect.getComputedTiming();
    const offsets = effect.getKeyframes().map(frame => frame.computedOffset);
    console.log(`Offsets: ${offsets.join(", ")}`);
    console.log(`${duration} ms × ${iterations} = ${activeDuration} ms; easing: ${easing}`);
    animation.cancel();
  })();
</script>
</html>

Resultaat

Offsets: 0, 0.5, 1
600 ms × 2.5 = 1500 ms; easing: ease-in-out

Sla het voorbeeld op als HTML-bestand, open het in een browser die WAAPI ondersteunt en bekijk de uitvoer in de ontwikkelaarsconsole. Het element wordt niet aan de pagina toegevoegd: het voorbeeld toont de berekende offsets en timingwaarden zonder te wachten en annuleert daarna de animatie.

Gerelateerde lessen

  • JavaScript · Les 29 · Gemiddeld · Versie: 3

Bronnen