Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

animation-range: escolher uma parte da linha temporal de deslocamento

Associe os mesmos fotogramas-chave a um intervalo de deslocamento escolhido, em vez de acrescentar um atraso medido em segundos.

Versão: CSS Modules

Sintaxe

animation-range: normal | <start> <end>?; /* comma-separated per animation */

animation-range é a propriedade abreviada de animation-range-start e animation-range-end. Define onde uma animação fica associada à sua linha temporal, não os limites de deslocamento do elemento. Numa animação controlada pelo deslocamento, as percentagens sem um intervalo com nome referem-se à linha temporal completa. Valores como entry ou exit referem-se antes a partes com nome de uma linha temporal de visibilidade; não são seletores de contentores de deslocamento. Vários intervalos separados por vírgulas correspondem à lista animation-name.

No exemplo, uma área visível de 200px contém 1000px de conteúdo, pelo que a distância de deslocamento é de 800px. O intervalo 25% 75% associa uma única transição linear de opacidade às posições entre 200px e 600px. As leituras em 0,200,400,600,800 dão opacidades de 0,0,0.5,1,1. Regressar a 400 repõe 0.5: o deslocamento controla a progressão nos dois sentidos. animation-fill-mode: both preserva os valores dos extremos fora desse intervalo; o intervalo, por si só, não solicita esse comportamento.

Omitir o fim tem dois significados distintos. Um 25% isolado define o início em 25% e repõe o fim em normal. Um entry isolado usa o princípio e o fim do intervalo entry; as duas propriedades individuais podem ser serializadas simplesmente como entry, apesar de os seus desvios predefinidos serem diferentes. O exemplo verifica estas propriedades após a análise sintática, mas não mede a geometria de entrada de uma linha temporal de visibilidade. Um par de segundos como 2s 4s é rejeitado.

Escreva animation-timeline e animation-range depois da propriedade abreviada animation, porque esta repõe os seus valores. Disponibilize uma alternativa estática utilizável e teste os navegadores de destino: trata-se de animações controladas pelo deslocamento, não de um substituto portável de animation-delay no relógio do documento. O exemplo mede a opacidade real após a renderização de fotogramas, sem recursos de rede nem dados de utilizadores.

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(',')};
box.style.animationRange='25% 75%';
const values=await sample([0,200,400,600,800,400]);
const shorthand=document.createElement('div').style;shorthand.animationRange='entry';const named=shorthand.animationRangeStart+' / '+shorthand.animationRangeEnd;
shorthand.animationRange='25%';const lone=shorthand.animationRangeStart+' / '+shorthand.animationRangeEnd;
console.log('scroll-range='+(scroller.scrollHeight-scroller.clientHeight)+'; opacity='+values+'; entry='+named+'; lone='+lone+'; seconds='+CSS.supports('animation-range','2s 4s'));

Resultado

scroll-range=800; opacity=0.00,0.00,0.50,1.00,1.00,0.50; entry=entry / entry; lone=25% / normal; seconds=false

Executado no Chromium 157.0.8103.51. A transição usa duração auto, uma iteração e progressão linear; outras definições de iteração, progressão ou preenchimento alteram o resultado visível.

Fontes