Movimiento de desplazamiento (Scroll motion)
El movimiento debe explicar la estructura: qué es nuevo, qué va junto, a qué mirar a continuación. La animación que no hace nada de esto es decoración y cuesta rendimiento, por lo que cada efecto a continuación está vinculado a un propósito.
Configuración
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/lenis@1/dist/lenis.min.js"></script>
<script defer src="/js/main.js"></script>
defer evita que los scripts bloqueen el primer pintado y aún así los ejecuta en orden, de modo que main.js (el código a continuación) ve gsap. Para producción, fija versiones exactas ([email protected]) o aloja los archivos localmente.
gsap.registerPlugin(ScrollTrigger);
const reduce = matchMedia("(prefers-reduced-motion: reduce)").matches;
if (!reduce) {
const lenis = new Lenis({ duration: 1.1, smoothWheel: true });
lenis.on("scroll", ScrollTrigger.update);
gsap.ticker.add((t) => lenis.raf(t * 1000));
gsap.ticker.lagSmoothing(0);
}
Envuelve cada animación en if (!reduce) o usa gsap.matchMedia(). Las personas con trastornos vestibulares establecen esa preferencia por una razón, y el contenido debe ser completamente visible sin movimiento.
Elección de un efecto
| Propósito | Efecto | Sección de referencia |
|---|---|---|
| Anunciar una nueva sección | Revelación de titular con máscara | Revelaciones |
| Mostrar que los elementos van juntos | Aparición escalonada con desvanecimiento | Revelaciones |
| Añadir profundidad a las imágenes | Paralaje, revelación con clip-path | Imágenes |
| Contar una secuencia | Pasos fijados, línea dibujada | Fijación |
| Mostrar un rango de trabajo | Desplazamiento horizontal | Fijación |
| Enfatizar un número | Contador ascendente | Detalles |
| Cubrir la carga inicial | Precargador | Detalles |
El código listo para copiar de cada uno está en references/snippets.md. Léelo cuando estés a punto de implementar un efecto; no lo necesitas para planificar.
Reglas internas
- Anima solo
transformyopacity. Animartop,width,marginobox-shadowdesencadena un nuevo layout o pintado en cada cuadro y causa tirones en teléfonos de gama media. - Duraciones: De 0.6 a 1.0s para revelaciones, de 0.2 a 0.3s para hovers. Las más largas se sienten lentas en la segunda visita.
- Easing:
power3.outpara entradas,power2.inOutpara transiciones,nonepara animaciones sincronizadas con desplazamiento (scrub aporta el easing). - Escalonado (stagger): De 0.06 a 0.12s. Limita el total: con 12 tarjetas, escalona las primeras 6 y agrupa el resto.
- Reproducir una vez. Usa
once: trueotoggleActions: "play none none none". Re-animar en cada desplazamiento hacia atrás es agotador. - Una pieza central por página. Una sección fijada o de desplazamiento horizontal es memorable una vez y agotadora tres veces.
- Establece el estado inicial en JS, no en CSS. Si el script falla al cargar, el contenido oculto por CSS permanece oculto para siempre.
- Actualizar después de cambios de layout: llama a
ScrollTrigger.refresh()después de que las fuentes y las imágenes se carguen, o las posiciones de los disparadores se desviarán.
window.addEventListener("load", () => ScrollTrigger.refresh());
document.fonts?.ready.then(() => ScrollTrigger.refresh());
Móvil
- Desactiva la fijación y el desplazamiento horizontal por debajo de 768px con
gsap.matchMedia(); apila el contenido normalmente. - El desplazamiento suave de Lenis en pantallas táctiles a menudo entra en conflicto con el impulso nativo. Deja el desplazamiento táctil nativo (el valor predeterminado) a menos que la persona insista.
- Reduce a la mitad las distancias de paralaje en pantallas pequeñas.
Depuración
- Añade
markers: truea un ScrollTrigger para ver las líneas de inicio y fin. - Los saltos al inicio de una fijación generalmente significan que el elemento fijado tiene un padre con transform o una altura cambiante.
- La animación se dispara demasiado pronto: las imágenes que están encima cargaron tarde. Establece
widthyheightexplícitos en las imágenes. - No se anima nada: verifica que el plugin esté registrado y que el selector coincida.
Sin GSAP
Para simples apariciones con desvanecimiento en un sitio pequeño, un IntersectionObserver que añade una clase más una transición CSS es suficiente y ahorra unos 70 KB. Consulta la última sección de references/snippets.md.