CKTIS / CSS
animation-range-end: definir o ponto final de associação
Escolha onde a animação selecionada atinge o fim do intervalo a que está associada, mantendo o início independente.
Versão: CSS Modules
Sintaxe
animation-range-end: normal | <length-percentage> | <timeline-range-name> <length-percentage>?;animation-range-end especifica o fim do intervalo de associação de uma animação. normal usa o fim da linha temporal associada. Uma percentagem ou um comprimento sem nome mede-se desde o início da linha temporal, não para trás desde o seu fim nem desde animation-range-start. Com um intervalo de visibilidade com nome, como exit 80%, o desvio é relativo a esse intervalo; apenas o nome representa, por predefinição, o seu ponto 100%. Um valor em segundos não é um extremo de intervalo válido.
Para uma única iteração com duração auto, um ponto final fixado mais cedo concentra a animação numa parte mais curta da distância de deslocamento. Não altera o fotograma-chave 100%, não impede o deslocamento da página nem remove o elemento. O que permanece visível depois do intervalo depende de animation-fill-mode. Defina o fim depois do início pretendido; pontos de associação invertidos ou coincidentes não servem para pedir uma animação ao contrário.
O exemplo mantém o início em normal numa distância de deslocamento de 800px. Com o fim em 50%, a opacidade nas posições 0,200,400,800 é 0,0.5,1,1. Definir o fim em 200px dá, por sua vez, 0,0.5,1,1 nas posições 0,100,200,400. Repor normal produz 0.5 na posição 400. São leituras reais do estilo, com progressão linear e preenchimento both; a mesma sequência de resultados representa intervalos físicos diferentes.
A propriedade pode conter uma lista separada por vírgulas, associada aos nomes das animações. A abreviatura animation repõe as propriedades do intervalo, por isso coloque esta declaração depois dela. Mantenha uma alternativa estática para navegadores sem animações controladas pelo deslocamento. O exemplo cobre uma linha temporal de progresso do deslocamento; os intervalos de visibilidade com nome são explicados separadamente e não são aqui apresentados como geometria testada.
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.animationRangeEnd='50%';
const percent=await sample([0,200,400,800]);
box.style.animationRangeEnd='200px';const length=await sample([0,100,200,400]);
box.style.animationRangeEnd='normal';const normal=await sample([400]);
console.log('start='+getComputedStyle(box).animationRangeStart+'; end50='+percent+'; end200px='+length+'; normalAt400='+normal+'; seconds='+CSS.supports('animation-range-end','2s'));Resultado
start=normal; end50=0.00,0.50,1.00,1.00; end200px=0.00,0.50,1.00,1.00; normalAt400=0.50; seconds=false
Executado no Chromium 157.0.8103.51 após dois fotogramas de renderização por alteração do deslocamento. As percentagens usam a distância de deslocamento, não a altura total do conteúdo de 1000px nem a altura visível de 200px.