CKTIS / CSS
animation-range-end: define el punto final de vinculación
Elige dónde la animación seleccionada llega al final de su rango de vinculación, manteniendo independiente su inicio.
Versión: CSS Modules
Sintaxis
animation-range-end: normal | <length-percentage> | <timeline-range-name> <length-percentage>?;animation-range-end especifica el final del rango de vinculación de una animación. normal utiliza el final de la línea de tiempo asociada. Un porcentaje o una longitud sin nombre se mide desde el inicio de la línea de tiempo, no hacia atrás desde su final ni desde animation-range-start. Con un rango de visibilidad con nombre, como exit 80%, el desplazamiento es relativo a ese rango; un nombre aislado representa por defecto su punto 100%. Un valor en segundos no es un extremo de rango válido.
Para una sola iteración con duración auto, un extremo fijo más temprano concentra la animación en una parte más corta de la distancia desplazable. No modifica el fotograma clave 100%, no impide desplazar la página ni elimina el elemento. Lo que permanece visible después del intervalo depende de animation-fill-mode. Coloca el final después del inicio previsto; los puntos de vinculación invertidos o coincidentes no sirven para solicitar una animación en sentido inverso.
El ejemplo mantiene el inicio en normal sobre una distancia desplazable de 800px. Con el final en 50%, la opacidad en las posiciones 0,200,400,800 es 0,0.5,1,1. Establecer el final en 200px da, en cambio, 0,0.5,1,1 en las posiciones 0,100,200,400. Restablecer normal produce 0.5 en la posición 400. Son lecturas reales del estilo con una curva linear y relleno both; la misma secuencia de resultados representa intervalos físicos distintos.
La propiedad puede contener una lista separada por comas que se corresponde con los nombres de las animaciones. La abreviatura animation restablece las propiedades de rango, así que coloca esta declaración después. Conserva una alternativa estática para navegadores sin animaciones controladas por desplazamiento. El ejemplo cubre una línea de tiempo de progreso del desplazamiento; los rangos de visibilidad con nombre se explican por separado y aquí no se presentan como geometría comprobada.
Ejemplos
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
Ejecutado en Chromium 157.0.8103.51 después de dos fotogramas renderizados por cada cambio de desplazamiento. Los porcentajes usan la distancia desplazable, no los 1000px de altura total del contenido ni los 200px de altura visible.