Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

animation-range : choisir une portion de la chronologie de défilement

Rattachez les mêmes images clés à un intervalle de défilement choisi, plutôt que d’ajouter un délai en secondes.

Version : CSS Modules

Syntaxe

animation-range: normal | <start> <end>?; /* comma-separated per animation */

animation-range est le raccourci de animation-range-start et animation-range-end. Il définit où une animation est rattachée à sa chronologie, et non les limites de défilement de l’élément. Pour une animation pilotée par le défilement, les pourcentages sans plage nommée se rapportent à toute la chronologie. Des valeurs comme entry ou exit désignent au contraire des portions nommées d’une chronologie de visibilité ; ce ne sont pas des sélecteurs de conteneurs de défilement. Plusieurs plages séparées par des virgules correspondent à la liste animation-name.

Dans l’exemple, une zone visible de 200px contient 1000px de contenu : la distance de défilement est donc de 800px. La plage 25% 75% rattache un fondu linéaire unique aux positions allant de 200px à 600px. Les lectures à 0,200,400,600,800 donnent les opacités 0,0,0.5,1,1. Revenir à 400 rétablit 0.5 : le défilement pilote la progression dans les deux sens. animation-fill-mode: both conserve les valeurs des extrémités en dehors de cet intervalle ; la plage seule ne demande pas ce comportement.

Omettre la fin peut avoir deux sens distincts. Un simple 25% fixe le début à 25% et réinitialise la fin à normal. Un simple entry utilise le début et la fin de la plage entry ; les deux propriétés détaillées peuvent se sérialiser simplement en entry, même si leurs décalages par défaut diffèrent. L’exemple vérifie ces propriétés après analyse, mais ne mesure pas la géométrie d’entrée d’une chronologie de visibilité. Une paire de secondes comme 2s 4s est rejetée.

Écrivez animation-timeline et animation-range après le raccourci animation, car celui-ci les réinitialise. Prévoyez une solution statique utilisable et testez les navigateurs visés : il s’agit d’animations pilotées par le défilement, pas d’un remplacement portable de animation-delay sur l’horloge du document. L’exemple mesure l’opacité réelle après le rendu des images, sans ressources réseau ni données utilisateur.

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(',')};
box.style.animationRange='25% 75%';
const values=await sample([0,200,400,600,800,400]);
const shorthand=document.createElement('div').style;shorthand.animationRange='entry';const named=shorthand.animationRangeStart+' / '+shorthand.animationRangeEnd;
shorthand.animationRange='25%';const lone=shorthand.animationRangeStart+' / '+shorthand.animationRangeEnd;
console.log('scroll-range='+(scroller.scrollHeight-scroller.clientHeight)+'; opacity='+values+'; entry='+named+'; lone='+lone+'; seconds='+CSS.supports('animation-range','2s 4s'));

Résultat

scroll-range=800; opacity=0.00,0.00,0.50,1.00,1.00,0.50; entry=entry / entry; lone=25% / normal; seconds=false

Exécuté dans Chromium 157.0.8103.51. Le fondu utilise une durée auto, une itération et une progression linéaire ; d’autres réglages d’itération, de progression ou de remplissage changent le résultat visible.

Sources