CKTIS / CSS
animation-range: elige un tramo de la línea de tiempo de desplazamiento
Vincula los mismos fotogramas clave a un intervalo de desplazamiento elegido, en lugar de añadir un retraso medido en segundos.
Versión: CSS Modules
Sintaxis
animation-range: normal | <start> <end>?; /* comma-separated per animation */animation-range es la propiedad abreviada de animation-range-start y animation-range-end. Define dónde se vincula una animación a su línea de tiempo, no los límites de desplazamiento del elemento. En una animación controlada por desplazamiento, los porcentajes sin un rango con nombre se refieren a toda la línea de tiempo. Valores como entry o exit se refieren, en cambio, a tramos con nombre de una línea de tiempo de visibilidad; no son selectores de contenedores de desplazamiento. Varios rangos separados por comas corresponden a la lista animation-name.
En el ejemplo, una zona visible de 200px contiene 1000px de contenido, por lo que la distancia desplazable es de 800px. El rango 25% 75% vincula una única transición lineal de opacidad a las posiciones entre 200px y 600px. Las lecturas en 0,200,400,600,800 dan opacidades de 0,0,0.5,1,1. Volver a 400 restablece 0.5: el desplazamiento controla el progreso en ambos sentidos. animation-fill-mode: both conserva los valores de los extremos fuera del intervalo; el rango por sí solo no solicita ese comportamiento.
Omitir el final tiene dos significados distintos. Un 25% aislado fija el inicio en 25% y restablece el final a normal. Un entry aislado utiliza el principio y el final del rango entry; sus dos propiedades individuales pueden serializarse simplemente como entry aunque sus desplazamientos predeterminados sean distintos. El ejemplo comprueba esas propiedades analizadas, pero no mide la geometría de entrada de una línea de tiempo de visibilidad. Se rechaza un par de segundos como 2s 4s.
Escribe animation-timeline y animation-range después de la propiedad abreviada animation, porque esta las restablece. Ofrece una alternativa estática útil y prueba los navegadores de destino: se trata de animaciones controladas por desplazamiento, no de un sustituto portable de animation-delay en el reloj del documento. El ejemplo mide la opacidad real después de renderizar fotogramas, sin recursos de red ni datos de usuarios.
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.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
Ejecutado en Chromium 157.0.8103.51. La transición utiliza duración auto, una iteración y una curva lineal; otros ajustes de iteración, curva o relleno cambian el resultado visible.