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

CKTIS / CSS

animation-timeline: elige qué controla la animación

Distingue el tiempo del documento, el progreso del desplazamiento y la visibilidad del elemento al elegir la línea de tiempo de una animación.

Versión: CSS Modules

Sintaxis

animation-timeline: auto | none | <dashed-ident> | scroll() | view();

animation-timeline selecciona la fuente de progreso de cada animación CSS. auto utiliza la línea de tiempo del documento, none no asocia ninguna línea de tiempo y un identificador con guiones como --track hace referencia a una línea de tiempo de desplazamiento o visibilidad con nombre dentro del ámbito. scroll() sigue el desplazamiento en el contenedor y el eje seleccionados; view() sigue el paso de un elemento por la zona visible de desplazamiento. Un nombre de fotogramas clave no define una línea de tiempo con el mismo nombre. Varios valores separados por comas corresponden a la lista animation-name.

La ausencia de una línea de tiempo con nombre no provoca una vuelta silenciosa al reloj del documento. Una línea de tiempo de desplazamiento también necesita una fuente válida con contenido desbordado desplazable en el eje elegido. none no equivale a animation-play-state: paused: no seleccionar ninguna línea de tiempo es distinto de conservar y pausar una posición de reproducción existente. En una animación controlada por desplazamiento, una duración auto y un número finito de iteraciones pueden distribuir el efecto por su rango de vinculación.

El ejemplo compara una línea de tiempo anónima scroll(nearest block) con --track, definida en el mismo contenedor de desplazamiento. En la posición 400 de un rango de 800px, ambas muestran una opacidad de 0.5. Cambiarlas a none y a una línea de tiempo --missing inexistente da la opacidad subyacente 0.2 con relleno none. Una animación aparte, pausada sobre el reloj del documento y medida en 500ms de una duración de un segundo, da 0.5. No intervienen ningún inicio de sesión, solicitud de red ni reloj externo.

La comprobación final muestra que una abreviatura animation posterior restablece a auto la línea de tiempo de desplazamiento elegida. Coloca las declaraciones de línea de tiempo y rango después de esa abreviatura para conservarlas. Prueba el comportamiento real en los navegadores de destino y ofrece contenido estático cuando no haya una línea de tiempo disponible. El ejemplo verifica líneas de tiempo de desplazamiento anónimas y con nombre, más un control con el reloj del documento; no afirma probar la geometría de view().

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(',')};
scroller.style.scrollTimeline='--track block';box.style.animationFillMode='none';
const named=box.cloneNode();named.style.animationTimeline='--track';space.append(named);
scroller.scrollTop=400;await frame();const halfway=[box,named].map(e=>Number(getComputedStyle(e).opacity).toFixed(2)).join(',');
box.style.animationTimeline='none';named.style.animationTimeline='--missing';await frame();const inactive=[box,named].map(e=>Number(getComputedStyle(e).opacity).toFixed(2)).join(',');
box.style.animation='fade 1s linear both paused';getComputedStyle(box).opacity;const time=box.getAnimations()[0];time.currentTime=500;const clock=Number(getComputedStyle(box).opacity).toFixed(2);
box.style.animationTimeline='scroll(nearest block)';const before=box.style.animationTimeline;box.style.animation='fade 2s linear';const after=getComputedStyle(box).animationTimeline;
console.log('halfwayAnonymousNamed='+halfway+'; inactiveNoneMissing='+inactive+'; clockAt500ms='+clock+'; reset='+before+' / '+after);

Resultado

halfwayAnonymousNamed=0.50,0.50; inactiveNoneMissing=0.20,0.20; clockAt500ms=0.50; reset=scroll() / auto

Ejecutado en Chromium 157.0.8103.51. El navegador serializa scroll(nearest block) como scroll(); los argumentos omitidos son los valores predeterminados, no una configuración perdida.

Fuentes