Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

animation-range-start: elige dónde comienza el progreso ligado al desplazamiento

Mueve el punto inicial de vinculación sin convertir un porcentaje en un retraso temporal.

Versión: CSS Modules

Sintaxis

animation-range-start: normal | <length-percentage> | <timeline-range-name> <length-percentage>?;

animation-range-start define el comienzo del rango de vinculación. normal selecciona el inicio de la línea de tiempo asociada. Un porcentaje sin rango con nombre se refiere a la línea de tiempo completa; una longitud indica una distancia desde su inicio. Con un rango de visibilidad con nombre, el desplazamiento se mide dentro de ese rango y, si se omite, se selecciona su punto 0%. Esto es independiente de la posición del elemento y de los propios selectores de fotogramas clave.

Con una iteración y duración auto, cambiar el inicio manteniendo fijo el final modifica la distancia a lo largo de la cual avanza la animación. Antes de ese intervalo, animation-fill-mode determina si sigue visible el fotograma inicial. Desplazarse hacia atrás permite volver a estados anteriores: el inicio no es un disparador de eventos de una sola ejecución. Usa animation-direction para el sentido de reproducción en lugar de confiar en un intervalo de vinculación invertido.

El ejemplo utiliza 800px de distancia desplazable, un final normal y fotogramas clave de opacidad lineales. Un inicio de 25% sitúa el comienzo en 200px. Las posiciones 0,200,500,800,500 dan opacidades de 0,0,0.5,1,0.5. Cambiar el inicio a 400px da 0,0.5,1 en las posiciones 400,600,800. Restablecer normal da 0.5 en 400. El relleno both conserva el valor inicial antes del rango; son resultados medidos, no porcentajes simulados.

Define el rango después de la abreviatura animation, que lo restablece, y combina la propiedad con una animation-timeline adecuada. Una lista separada por comas corresponde a animation-name. La compatibilidad con líneas de tiempo de desplazamiento varía, así que ofrece una alternativa estática útil. La prueba rechaza un valor en segundos y no afirma medir la geometría de rangos de visibilidad con nombre.

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.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

Ejecutado en Chromium 157.0.8103.51. La prueba espera los fotogramas renderizados después de desplazar; no instala un listener de desplazamiento ni modifica la página del usuario de la lección.

Fuentes