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

CKTIS / CSS

animation-range-end : définir le point final de rattachement

Choisissez où l’animation sélectionnée atteint la fin de sa plage de rattachement, tout en gardant son début indépendant.

Version : CSS Modules

Syntaxe

animation-range-end: normal | <length-percentage> | <timeline-range-name> <length-percentage>?;

animation-range-end définit la fin de la plage de rattachement d’une animation. normal utilise la fin de la chronologie associée. Un pourcentage ou une longueur seuls se mesurent depuis le début de la chronologie, et non à rebours depuis sa fin ni depuis animation-range-start. Avec une plage de visibilité nommée, comme exit 80%, le décalage se rapporte à cette plage ; un nom seul désigne par défaut son point 100%. Une valeur en secondes n’est pas une extrémité de plage valide.

Pour une seule itération de durée auto, un point final fixé plus tôt concentre l’animation sur une portion plus courte de la distance de défilement. Il ne modifie pas l’image clé 100%, n’empêche pas le défilement de la page et ne supprime pas l’élément. Ce qui reste visible après l’intervalle dépend de animation-fill-mode. Placez la fin après le début prévu ; des points de rattachement inversés ou confondus ne permettent pas de demander une animation à l’envers.

L’exemple conserve un début normal sur une distance de défilement de 800px. Avec une fin à 50%, les opacités aux positions 0,200,400,800 valent 0,0.5,1,1. Une fin à 200px donne plutôt 0,0.5,1,1 aux positions 0,100,200,400. Rétablir normal produit 0.5 à la position 400. Il s’agit de lectures réelles du style avec une progression linear et un remplissage both ; la même suite de résultats représente des intervalles physiques différents.

La propriété peut contenir une liste séparée par des virgules, associée aux noms d’animations. Le raccourci animation réinitialise les propriétés de plage : placez donc cette déclaration après lui. Conservez une présentation statique de secours pour les navigateurs sans animations pilotées par le défilement. L’exemple couvre une chronologie de progression du défilement ; les plages de visibilité nommées sont expliquées séparément et ne sont pas présentées ici comme une géométrie testée.

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.animationRangeEnd='50%';
const percent=await sample([0,200,400,800]);
box.style.animationRangeEnd='200px';const length=await sample([0,100,200,400]);
box.style.animationRangeEnd='normal';const normal=await sample([400]);
console.log('start='+getComputedStyle(box).animationRangeStart+'; end50='+percent+'; end200px='+length+'; normalAt400='+normal+'; seconds='+CSS.supports('animation-range-end','2s'));

Résultat

start=normal; end50=0.00,0.50,1.00,1.00; end200px=0.00,0.50,1.00,1.00; normalAt400=0.50; seconds=false

Exécuté dans Chromium 157.0.8103.51 après deux images de rendu par changement de défilement. Les pourcentages utilisent la distance de défilement, pas la hauteur totale du contenu de 1000px ni celle de la zone visible de 200px.

Sources