KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

KeyframeEffect — een keyframe-animatie-effect

KeyframeEffect beschrijft het doel, de keyframes en de timingparameters van een effect. Een afzonderlijk Animation-object bestuurt de weergave.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new KeyframeEffect(target, keyframes, options)
new KeyframeEffect(source)

KeyframeEffect is een interface van Web Animations en geen onderdeel van ECMAScript. De interface erft van AnimationEffect en beschrijft wijzigingen aan CSS-eigenschappen. Alleen het aanmaken start de weergave niet: wijs het effect toe aan een Animation-object, waarvan de methode play() de weergave start. De verkorte vorm Element.animate() maakt het effect en de animatie aan en start de weergave.

target is een element of null. keyframes accepteert een array met keyframes of een object met eigenschapswaarden. options is de duur van één iteratie in milliseconden of een object met instellingen zoals duration, delay, iterations, easing en fill. Expliciete offset-waarden moeten binnen [0, 1] liggen en niet-aflopend zijn geordend. new KeyframeEffect(source) kopieert de effectdefinitie, niet de afspeelstatus van de animatie.

getKeyframes() geeft keyframes met berekende offsets terug en setKeyframes() vervangt de set. De overgeërfde methode updateTiming() wijzigt timingparameters, terwijl getComputedTiming() de berekende voortgang beschikbaar maakt. In het voorbeeld kiest currentTime = 500 het midden van één iteratie van 1000 ms, zonder de weergave te starten.

Dit is een Window-API; Node 24 in de repository toont niet aan dat deze in een browser beschikbaar is. Controleer de beschikbaarheid in de doelomgeving; het voorbeeld controleert de constructors, maar toont geen ondersteuning voor elke optie aan.

Voorbeelden

(() => {
  if (typeof KeyframeEffect !== "function" || typeof Animation !== "function") {
    throw new Error("Web Animations API required");
  }
  const target = document.createElement("div");
  const effect = new KeyframeEffect(
    target,
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, easing: "linear" }
  );
  const animation = new Animation(effect, document.timeline);
  animation.currentTime = 500;
  console.log(effect.getKeyframes().length);
  console.log(effect.getComputedTiming().progress);
  animation.cancel();
})();

Resultaat

2
0.5

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