Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

animation-timeline: vyberte, co řídí animaci

Při výběru časové osy rozlišujte čas dokumentu, průběh posouvání a viditelnost prvku.

Verze: CSS Modules

Syntaxe

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

animation-timeline vybírá zdroj průběhu pro každou CSS animaci. auto používá časovou osu dokumentu, none nepřiřadí žádnou osu a identifikátor se dvěma pomlčkami, například --track, odkazuje na pojmenovanou osu posouvání či viditelnosti v daném rozsahu platnosti. scroll() sleduje posouvání vybraného kontejneru ve zvoleném směru; view() sleduje průchod prvku oblastí posouvání. Název klíčových snímků nevytváří stejně pojmenovanou časovou osu. Více hodnot oddělených čárkami odpovídá seznamu animation-name.

Chybějící pojmenovaná osa nepřejde tiše na hodiny dokumentu. Osa posouvání navíc potřebuje platný posuvný zdroj s posouvatelným přesahem v daném směru. none není totéž jako animation-play-state: paused: nepřiřadit osu se liší od zachování a pozastavení existující pozice. U animace řízené posouváním může doba auto s konečným počtem iterací rozložit efekt přes celý rozsah připojení.

Příklad porovnává anonymní osu scroll(nearest block) s --track definovanou na stejném posuvném prvku. Při pozici 400 z rozsahu 800px mají obě opacity 0.5. Změna na none a na chybějící osu --missing vrací při vyplnění none základní opacity 0.2. Samostatná pozastavená animace na hodinách dokumentu, měřená v 500ms z jednosekundové doby, dává 0.5. Není potřeba přihlášení, síťový požadavek ani externí hodiny.

Závěrečná kontrola ukazuje, že pozdější zkrácený zápis animation resetuje vybranou osu posouvání na auto. Deklarace osy a rozsahu pište za tuto zkratku, aby zůstaly zachovány. Ověřte skutečné chování v cílových prohlížečích a nabídněte statický obsah, pokud osa není dostupná. Příklad ověřuje pojmenované i anonymní osy posouvání a kontrolní animaci dokumentu; netvrdí, že zkoumá geometrii view().

Pří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ýsledek

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

Spuštěno v Chromium 157.0.8103.51. Prohlížeč serializuje scroll(nearest block) jako scroll(); vynechané argumenty jsou výchozí hodnoty, nikoli ztracené nastavení.

Zdroje