CKTIS / CSS
animation-timeline : choisir ce qui pilote l’animation
Distinguez temps du document, progression du défilement et visibilité de l’élément en choisissant la chronologie d’une animation.
Version : CSS Modules
Syntaxe
animation-timeline: auto | none | <dashed-ident> | scroll() | view();animation-timeline sélectionne la source de progression de chaque animation CSS. auto utilise la chronologie du document, none n’associe aucune chronologie, et un identifiant à tirets tel que --track fait référence à une chronologie nommée de défilement ou de visibilité accessible dans cette portée. scroll() suit le défilement du conteneur et de l’axe choisis ; view() suit le passage d’un élément dans la zone visible de défilement. Un nom d’images clés ne définit pas une chronologie du même nom. Plusieurs valeurs séparées par des virgules correspondent à la liste animation-name.
Une chronologie nommée manquante ne provoque pas un retour silencieux à l’horloge du document. Une chronologie de défilement exige aussi une source valide avec un débordement pouvant défiler sur l’axe choisi. none n’est pas équivalent à animation-play-state: paused : ne sélectionner aucune chronologie diffère du fait de conserver et mettre en pause une position de lecture existante. Avec une animation pilotée par le défilement, une durée auto et un nombre fini d’itérations peuvent répartir l’effet sur sa plage de rattachement.
L’exemple compare une chronologie anonyme scroll(nearest block) à --track, définie sur le même conteneur de défilement. À la position 400 d’une plage de 800px, les deux montrent une opacité de 0.5. Les remplacer par none et par une chronologie --missing absente donne l’opacité sous-jacente 0.2 avec le remplissage none. Une animation distincte sur l’horloge du document, en pause et mesurée à 500ms d’une durée d’une seconde, donne 0.5. Aucune connexion, requête réseau ni horloge externe n’intervient.
La dernière vérification montre qu’un raccourci animation ultérieur réinitialise la chronologie de défilement choisie à auto. Placez les déclarations de chronologie et de plage après ce raccourci pour les conserver. Testez le comportement réel dans les navigateurs visés et proposez un contenu statique si la chronologie est indisponible. L’exemple vérifie les chronologies de défilement nommées et anonymes ainsi qu’un contrôle sur l’horloge du document ; il ne prétend pas tester la géométrie de view().
Exemples
const style=document.createElement('style');style.textContent='@keyframes fade{from{opacity:0}to{opacity:1}}';document.head.append(style);
const scroller=document.createElement('div');scroller.style.cssText='height:200px;width:200px;overflow:auto;scroll-behavior:auto';
const space=document.createElement('div');space.style.height='1000px';
const box=document.createElement('div');box.style.cssText='height:20px;width:20px;opacity:.2;animation:fade auto linear both;animation-timeline:scroll(nearest block)';
space.append(box);scroller.append(space);document.body.append(scroller);
const frame=()=>new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(resolve)));
const sample=async positions=>{const values=[];for(const y of positions){scroller.scrollTop=y;await frame();values.push(Number(getComputedStyle(box).opacity).toFixed(2));}return values.join(',')};
scroller.style.scrollTimeline='--track block';box.style.animationFillMode='none';
const named=box.cloneNode();named.style.animationTimeline='--track';space.append(named);
scroller.scrollTop=400;await frame();const halfway=[box,named].map(e=>Number(getComputedStyle(e).opacity).toFixed(2)).join(',');
box.style.animationTimeline='none';named.style.animationTimeline='--missing';await frame();const inactive=[box,named].map(e=>Number(getComputedStyle(e).opacity).toFixed(2)).join(',');
box.style.animation='fade 1s linear both paused';getComputedStyle(box).opacity;const time=box.getAnimations()[0];time.currentTime=500;const clock=Number(getComputedStyle(box).opacity).toFixed(2);
box.style.animationTimeline='scroll(nearest block)';const before=box.style.animationTimeline;box.style.animation='fade 2s linear';const after=getComputedStyle(box).animationTimeline;
console.log('halfwayAnonymousNamed='+halfway+'; inactiveNoneMissing='+inactive+'; clockAt500ms='+clock+'; reset='+before+' / '+after);Résultat
halfwayAnonymousNamed=0.50,0.50; inactiveNoneMissing=0.20,0.20; clockAt500ms=0.50; reset=scroll() / auto
Exécuté dans Chromium 157.0.8103.51. Le navigateur sérialise scroll(nearest block) en scroll() ; les arguments omis sont les valeurs par défaut, pas une configuration perdue.