Clase 03 · Módulo 06
Scroll y secuencias con GSAP
Scroll y secuencias con GSAP
Qué logras en esta clase
Agregas animaciones de scroll y secuencias coordinadas, y sabes revisar el código que las produce.
- Entiendes las tres piezas de GSAP: tween, línea de tiempo y ScrollTrigger.
- Conoces qué permite y qué no su licencia.
- Depuras una animación de scroll con marcadores.
- La apagas para quien pide menos movimiento.
02
Cuándo entra GSAP
GSAP entra cuando la animación depende del scroll o cuando varias piezas deben moverse coordinadas. Para todo lo demás, CSS.
03
Qué es GSAP
Es una biblioteca de JavaScript para animar. Una biblioteca es código ya escrito que tu proyecto instala y usa. Sus tres piezas:
| Pieza | Qué hace |
|---|---|
| Tween | Lleva un elemento de un estado a otro |
| Timeline | Ordena varios tweens en una secuencia |
| ScrollTrigger | Conecta una animación con la posición del scroll |
ScrollTrigger es un plugin: una parte opcional que se activa aparte.
04
La licencia: gratis, pero no abierta
- Es gratis para todos, también para uso comercial.
- Incluye los plugins que antes eran de pago.
- No es código abierto. Es una licencia propia de Webflow, la empresa dueña de GSAP.
- Prohíbe usarlo dentro de herramientas para crear animaciones sin código que compitan con Webflow.
- Webflow puede modificarla; quien no acepte un cambio puede seguir con una versión anterior.
05
Qué significa para tu proyecto
| Caso | ¿Permitido? |
|---|---|
| Tu propia web | Sí |
| La web de un cliente que te paga | Sí |
| Código GSAP escrito por Claude | Sí |
| Un constructor visual de animaciones | No |
06
Instalar y comprobar
- En la terminal del proyecto, ejecuta
npm install gsap. - Comprueba la versión instalada en
package.json. - Si quieres saber cuál es la vigente, ejecuta
npm view gsap version.
En Astro, el código de GSAP va dentro de una etiqueta script en el componente que anima. Astro lo empaqueta y lo envía solo a las páginas que usan ese componente.
07
Tu primer tween
import { gsap } from "gsap";
gsap.to(".sello", { rotation: 360, duration: 1 });Se lee así: toma lo que tenga la clase sello y llévalo hasta una rotación de 360 grados en un segundo.
Dos detalles que confunden al principio: la duración va en segundos, no en milisegundos, y x, y, rotation y scale son atajos de transform.
08
Hacia, desde, o ambos
| Método | Qué defines |
|---|---|
gsap.to | El estado final. Parte desde como está hoy |
gsap.from | El estado inicial. Termina como está en tu CSS |
gsap.fromTo | Ambos |
Para entradas, from suele ser el más seguro: el estado final es tu diseño tal como ya lo construiste.
09
El contenido no espera a JavaScript
Con from, es GSAP quien esconde el elemento antes de animarlo. Si el script no carga, el contenido queda visible, como debe ser.
10
Una línea de tiempo
const tl = gsap.timeline({ defaults: { duration: 0.5 } });
tl.from(".titulo", { opacity: 0, y: 20 })
.from(".bajada", { opacity: 0, y: 20 })
.from(".boton", { opacity: 0 });Cada paso empieza cuando termina el anterior. defaults evita repetir la duración en cada línea; un paso puede sobrescribirla.
La línea de tiempo se guarda en una variable, y con ella puedes pausar, reanudar, invertir o reiniciar la secuencia completa.
11
Solapar y separar pasos
Un tercer dato en cada paso indica cuándo empieza:
| Valor | Efecto |
|---|---|
| (nada) | Al terminar el paso anterior |
"<" | Junto con el paso anterior |
"-=0.2" | 0,2 s antes de que termine el anterior |
"+=0.5" | 0,5 s después de que termine |
tl.from(".bajada", { opacity: 0 }, "-=0.2");12
Por qué no usar retrasos sueltos
Con retrasos calculados a mano, cambiar una duración te obliga a corregir todas las siguientes. En una línea de tiempo, el resto se reacomoda solo.
13
Activar ScrollTrigger
import { gsap } from "gsap";
import { ScrollTrigger } from "gsap/ScrollTrigger";
gsap.registerPlugin(ScrollTrigger);Registrar el plugin es obligatorio y se hace una vez. Además de activarlo, evita que el proceso de construcción lo descarte por creer que no se usa.
14
Animar cuando la sección entra en pantalla
gsap.from(".tarjeta", {
opacity: 0,
y: 24,
scrollTrigger: ".tarjeta",
});La forma corta: scrollTrigger recibe el elemento que hace de disparador. La animación corre cuando ese elemento entra en la pantalla.
Para afinar, en vez de un texto se entrega un bloque con opciones.
15
Las opciones que más vas a ver
| Opción | Qué controla |
|---|---|
trigger | El elemento que dispara |
start | Dónde empieza. Por defecto "top bottom" |
end | Dónde termina. Por defecto "bottom top" |
scrub | Liga el avance al scroll |
pin | Deja el elemento fijo mientras dura |
once | Se ejecuta una vez y se desactiva |
"top bottom" se lee: cuando el borde superior del disparador toca el borde inferior de la pantalla.
16
Disparar o ligar al scroll
| Disparar | Ligar (scrub) | |
|---|---|---|
| Qué pasa | La animación corre a su ritmo | Avanza y retrocede con el scroll |
| Úsalo para | Entradas de secciones | Barras de progreso, relatos por etapas |
| Riesgo | Bajo | Se siente pesado si se abusa |
scrub: true sigue al scroll de forma exacta. Con un número, por ejemplo scrub: 1, la animación tarda ese tiempo en alcanzarlo y se ve más suave.
17
Cómo trabaja por dentro
Los puntos de inicio y fin se calculan una vez y se recalculan cuando cambia el tamaño de la ventana. Si el alto de la página cambia después por otra razón, quedan corridos.
18
Depurar con marcadores
- Pídele a Claude que agregue
markers: trueal ScrollTrigger que falla. - Recarga: verás en pantalla las marcas de inicio (verde) y fin (rojo).
- Haz scroll y mira en qué momento se cruzan.
- Ajusta
startyendhasta que coincida con lo que quieres. - Quita los marcadores.
19
Menos movimiento y tamaños de pantalla
const mm = gsap.matchMedia();
mm.add("(prefers-reduced-motion: no-preference)", () => {
// las animaciones se crean aquí dentro
});gsap.matchMedia() ejecuta un bloque solo cuando una consulta de medios se cumple. Aquí, solo si el visitante no pidió reducir el movimiento. Si la condición deja de cumplirse, GSAP deshace esas animaciones.
Sirve igual con anchos de pantalla, para simplificar un efecto en el celular.
20
Fijar un elemento sin romper la página
La documentación indica animar lo que está dentro del elemento fijado, no el elemento mismo. También recomienda crear los ScrollTrigger en el orden en que aparecen en la página, de arriba hacia abajo.
Fijar secciones es el efecto que más problemas da en celulares. Úsalo una vez o ninguna.
21
GSAP junto al enrutador de Astro
Si activaste ClientRouter en la clase anterior, recuerda que los scripts empaquetados corren una sola vez.
Las animaciones deben crearse dentro del evento astro:page-load, para que se armen de nuevo en cada navegación. Pídeselo a Claude de forma explícita y prueba entrando a la página animada desde otra, no solo recargándola.
22
Lo que cuesta y cuándo no conviene
- Es JavaScript adicional que el navegador descarga y ejecuta. Mide el efecto en el módulo 9.
- Muchas animaciones de scroll en una página larga afectan la respuesta en celulares modestos.
- Si solo quieres que las secciones aparezcan con un fundido, es mucha herramienta para poco efecto.
No conviene en una landing simple, en páginas donde la velocidad es la prioridad, ni como primera opción.
23
Cómo pedírselo a Claude
Describe el disparador, el efecto, el modo y los límites.
24
Lo que te llevas
- Tween para un cambio, timeline para una secuencia, ScrollTrigger para atarla al scroll.
- GSAP es gratis también para uso comercial, pero su licencia es propia y puede cambiar.
- El plugin se registra siempre; los marcadores muestran dónde empieza y termina.
gsap.matchMedia()apaga las animaciones para quien pide menos movimiento.- Pesa: se usa donde CSS no alcanza.
25
Hazlo ahora
En 15 minutos:
- Elige una sola sección de tu web donde una secuencia ayude a entender, por ejemplo los pasos de un proceso.
- Instala GSAP y pídele a Claude la secuencia con el nivel de detalle del ejemplo.
- Ajusta el inicio con los marcadores a la vista.
- Emula
prefers-reduced-motiony confirma que la sección se lee completa y quieta. - Quita los marcadores y haz commit.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026