CKTIS / CSS
animation-timeline: escolher o que controla a animação
Distinga o tempo do documento, o progresso do deslocamento e a visibilidade do elemento ao escolher a linha temporal de uma animação.
Versão: CSS Modules
Sintaxe
animation-timeline: auto | none | <dashed-ident> | scroll() | view();animation-timeline seleciona a fonte de progressão de cada animação CSS. auto usa a linha temporal do documento, none não associa nenhuma linha temporal e um identificador com hífenes, como --track, refere-se a uma linha temporal de deslocamento ou visibilidade com nome disponível nesse âmbito. scroll() acompanha o deslocamento no contentor e no eixo selecionados; view() acompanha a passagem de um elemento pela área visível de deslocamento. Um nome de fotogramas-chave não define uma linha temporal com o mesmo nome. Vários valores separados por vírgulas correspondem à lista animation-name.
Uma linha temporal com nome inexistente não provoca um regresso silencioso ao relógio do documento. Uma linha temporal de deslocamento também precisa de uma fonte válida com conteúdo excedente que se possa deslocar no eixo escolhido. none não equivale a animation-play-state: paused: não selecionar uma linha temporal é diferente de manter e pausar uma posição de reprodução existente. Numa animação controlada pelo deslocamento, duração auto e um número finito de iterações podem distribuir o efeito pelo intervalo de associação.
O exemplo compara uma linha temporal anónima scroll(nearest block) com --track, definida no mesmo contentor de deslocamento. Na posição 400 de um intervalo de 800px, ambas mostram opacidade 0.5. Alterá-las para none e para uma linha temporal --missing inexistente dá a opacidade subjacente 0.2 com preenchimento none. Uma animação separada, em pausa no relógio do documento e medida em 500ms de uma duração de um segundo, dá 0.5. Não intervêm qualquer início de sessão, pedido de rede ou relógio externo.
A verificação final mostra que uma abreviatura animation posterior repõe a linha temporal de deslocamento escolhida em auto. Coloque as declarações de linha temporal e intervalo depois dessa abreviatura para as preservar. Teste o comportamento real nos navegadores de destino e forneça conteúdo estático quando uma linha temporal não estiver disponível. O exemplo verifica linhas temporais de deslocamento com nome e anónimas, além de um controlo com o relógio do documento; não afirma testar a geometria de view().
Exemplos
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);Resultado
halfwayAnonymousNamed=0.50,0.50; inactiveNoneMissing=0.20,0.20; clockAt500ms=0.50; reset=scroll() / auto
Executado no Chromium 157.0.8103.51. O navegador serializa scroll(nearest block) como scroll(); os argumentos omitidos são os predefinidos, não uma configuração perdida.