Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / CSS

animation-timeline: vyberte, čo riadi animáciu

Pri výbere osi odlišujte čas dokumentu, priebeh posúvania a viditeľnosť prvku.

Verzia: CSS Modules

Syntax

animation-timeline: auto | none | <dashed-ident> | scroll() | view();

animation-timeline vyberá zdroj priebehu každej CSS animácie. auto používa časovú os dokumentu, none nepriradí žiadnu os a identifikátor s dvoma pomlčkami, napríklad --track, odkazuje na pomenovanú os posúvania alebo viditeľnosti v príslušnom rozsahu platnosti. scroll() sleduje posúvanie vybraného kontajnera vo zvolenom smere; view() sleduje prechod prvku cez oblasť posúvania. Názov kľúčových snímok nedefinuje časovú os s rovnakým názvom. Viaceré hodnoty oddelené čiarkami zodpovedajú zoznamu animation-name.

Chýbajúca pomenovaná os sa potichu neprepne na hodiny dokumentu. Os posúvania potrebuje platný zdroj s posúvateľným presahom vo vybranom smere. none nie je to isté ako animation-play-state: paused: nepriradenie osi sa líši od zachovania a pozastavenia existujúcej pozície. Pri animácii riadenej posúvaním môže trvanie auto s konečným počtom iterácií rozložiť efekt cez jeho rozsah pripojenia.

Príklad porovnáva anonymnú os scroll(nearest block) s --track definovanou na tom istom posúvanom prvku. Pri pozícii 400 z rozsahu 800px obe ukazujú opacity 0.5. Zmena na none a chýbajúcu os --missing pri výplni none dáva základnú opacity 0.2. Samostatná pozastavená animácia na hodinách dokumentu, meraná pri 500ms z jednej sekundy, dáva 0.5. Nevyžaduje prihlásenie, sieťovú požiadavku ani externé hodiny.

Záverečná kontrola ukazuje, že neskoršia skratka animation resetuje vybranú os posúvania na auto. Deklarácie osi a rozsahu umiestnite za túto skratku, aby sa zachovali. Overujte skutočné správanie v cieľových prehliadačoch a poskytnite statický obsah, keď os nie je dostupná. Príklad overuje pomenované a anonymné osi posúvania aj kontrolnú animáciu dokumentu; netvrdí, že skúša geometriu view().

Príklady

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);

Výsledok

halfwayAnonymousNamed=0.50,0.50; inactiveNoneMissing=0.20,0.20; clockAt500ms=0.50; reset=scroll() / auto

Vykonané v Chromium 157.0.8103.51. Prehliadač serializuje scroll(nearest block) ako scroll(); vynechané argumenty sú predvolené hodnoty, nie stratená konfigurácia.

Zdroje