CKTIS / CSS
animation-range-start: escolher onde começa a progressão controlada pelo deslocamento
Mova o ponto inicial de associação sem transformar uma percentagem num atraso temporal.
Versão: CSS Modules
Sintaxe
animation-range-start: normal | <length-percentage> | <timeline-range-name> <length-percentage>?;animation-range-start define o início do intervalo de associação. normal seleciona o início da linha temporal associada. Uma percentagem sem intervalo com nome refere-se à linha temporal completa; um comprimento fornece uma distância a partir do seu início. Com um intervalo de visibilidade com nome, o desvio mede-se dentro desse intervalo e, se for omitido, seleciona-se o ponto 0%. Isto é independente da posição do elemento e dos próprios seletores de fotogramas-chave.
Com uma iteração e duração auto, alterar o início mantendo o fim fixo muda a distância ao longo da qual a animação progride. Antes desse intervalo, animation-fill-mode determina se o fotograma inicial permanece visível. Deslocar para trás pode recuperar estados anteriores: o início não é um evento que se desencadeia uma única vez. Use animation-direction para o sentido de reprodução, em vez de depender de um intervalo de associação invertido.
O exemplo usa 800px de distância de deslocamento, fim normal e fotogramas-chave lineares de opacidade. Um início de 25% coloca o começo em 200px. As posições 0,200,500,800,500 dão opacidades de 0,0,0.5,1,0.5. Mudar o início para 400px dá 0,0.5,1 nas posições 400,600,800. Repor normal dá 0.5 em 400. O preenchimento both preserva o valor inicial antes do intervalo; são resultados medidos, não percentagens simuladas.
Defina o intervalo depois da abreviatura animation, que o repõe, e combine a propriedade com uma animation-timeline adequada. Uma lista separada por vírgulas corresponde a animation-name. O suporte de linhas temporais de deslocamento varia, por isso disponibilize uma alternativa estática útil. O teste rejeita um valor em segundos e não afirma medir a geometria de intervalos de visibilidade com nome.
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.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'));Resultado
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
Executado no Chromium 157.0.8103.51. O teste aguarda os fotogramas renderizados após o deslocamento; não instala um listener de deslocamento nem altera a página do utilizador da lição.