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

CKTIS / CSS

animation-range-start : choisir le début de la progression liée au défilement

Déplacez le point initial de rattachement sans transformer un pourcentage en délai temporel.

Version : CSS Modules

Syntaxe

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

animation-range-start définit le début de la plage de rattachement. normal sélectionne le début de la chronologie associée. Un pourcentage sans plage nommée se rapporte à toute la chronologie ; une longueur donne une distance depuis son début. Dans une plage de visibilité nommée, le décalage se mesure à l’intérieur de cette plage, et son omission sélectionne le point 0%. Cela est distinct de la position de l’élément et des sélecteurs des images clés elles-mêmes.

Avec une itération et une durée auto, modifier le début en conservant la fin change la distance sur laquelle l’animation progresse. Avant cet intervalle, animation-fill-mode détermine si l’image initiale reste visible. Revenir en arrière dans le défilement peut retrouver des états précédents : le début n’est pas un déclencheur d’événement unique. Utilisez animation-direction pour le sens de lecture plutôt qu’un intervalle de rattachement inversé.

L’exemple utilise 800px de distance de défilement, une fin normal et des images clés d’opacité linéaires. Un début à 25% place le commencement à 200px. Les positions 0,200,500,800,500 donnent les opacités 0,0,0.5,1,0.5. Déplacer le début à 400px donne 0,0.5,1 aux positions 400,600,800. Rétablir normal donne 0.5 à 400. Le remplissage both conserve la valeur initiale avant la plage ; ces résultats sont mesurés, pas simulés à partir des pourcentages.

Définissez la plage après le raccourci animation, qui la réinitialise, et associez la propriété à une animation-timeline appropriée. Une liste séparée par des virgules correspond à animation-name. La prise en charge des chronologies de défilement varie : proposez donc une présentation statique de secours utile. Le test rejette une valeur en secondes et ne prétend pas mesurer la géométrie des plages de visibilité nommées.

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

Résultat

end=normal; start25=0.00,0.00,0.50,1.00,0.50; start400px=0.00,0.50,1.00; normalAt400=0.50; seconds=false

Exécuté dans Chromium 157.0.8103.51. Le test attend les images rendues après le défilement ; il n’installe aucun écouteur de défilement et ne modifie pas la page de l’utilisateur de la leçon.

Sources