Habilidad de Animaciones Avanzadas por Scroll
Cuándo usar esta habilidad
- Cuando la habilidad de
arquitectura-basada-en-nivelesindique un sitio de nivel "Premium 2D" o superior. - Cuando el usuario pida que elementos aparezcan gradualmente, se deslicen hacia arriba, escalen o se fijen al hacer scroll hacia abajo.
- Al construir una landing page centrada en storytelling (por ejemplo, revelaciones de producto al estilo Apple).
Directrices de Tono e Idioma (Crítico)
- Siempre comunícate con el usuario en el dialecto local jordano/palestino (اللهجة الأردنية والفلسطينية).
- Sé profesional pero accesible: "يا هلا", "رتبتلك السكرول", "الأنيميشن صار جاهز".
- Explica las decisiones técnicas de forma natural en árabe mezclado con términos web en inglés: "رح نستخدم
Framer Motionعشان حركات السكرول تطلع Smooth".
1. Configuración y Fundamentos
Si faltan estas bibliotecas, instálalas: @studio-freight/lenis (para la base de desplazamiento suave) y framer-motion (para animaciones a nivel de componente).
Configuración de Lenis para Desplazamiento Suave
Cada sitio que use esta habilidad debe tener una base de desplazamiento suave para que las animaciones se sientan premium.
- Configura
Lenisen un componente de alto nivel (por ejemplo,SmoothScrollProvider.tsxolayout.tsx).
// Ejemplo de configuración de Lenis
"use client";
import React, { useEffect } from 'react';
import Lenis from '@studio-freight/lenis';
export default function SmoothScroll({ children }: { children: React.ReactNode }) {
useEffect(() => {
const lenis = new Lenis({
duration: 1.2,
easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)),
orientation: 'vertical',
gestureOrientation: 'vertical',
smoothWheel: true,
wheelMultiplier: 1,
touchMultiplier: 2,
});
function raf(time: number) {
lenis.raf(time);
requestAnimationFrame(raf);
}
requestAnimationFrame(raf);
return () => {
lenis.destroy();
};
}, []);
return <>{children}</>;
}
2. Patrones de Animación (Framer Motion)
Al construir secciones, usa los siguientes patrones para un acabado de alta gama:
A. "Revelación con Desplazamiento Hacia Arriba"
Úsalo para encabezados y bloques de texto grandes al entrar al viewport.
- Hook:
useInViewo<motion.div whileInView={...} viewport={{ once: true, margin: "-10%" }}> - Estado inicial:
opacity: 0, y: 40 - Estado animado:
opacity: 1, y: 0 - Transición:
duration: 0.8, ease: [0.16, 1, 0.3, 1](la personalización del easing es crucial para un acabado premium).
B. "Imagen con Efecto Parallax"
Las imágenes deben moverse un poco más lento o más rápido que la posición del scroll.
- Hook:
useScrollyuseTransform. - Implementación:
const { scrollYProgress } = useScroll({ target: containerRef, offset: ["start end", "end start"] });
const y = useTransform(scrollYProgress, [0, 1], ["-20%", "20%"]);
- Envuelve la imagen en un contenedor con
overflow-hidden, y aplica la transformaciónyalmotion.imginterno.
C. "Lista Escalonada"
Para grids de características, miembros del equipo o tarjetas de precios.
- Padre:
<motion.div variants={containerVariants} initial="hidden" whileInView="show" viewport={{ once: true }}> - Variants (Padre):
{ hidden: { opacity: 0 }, show: { opacity: 1, transition: { staggerChildren: 0.1 } } } - Variants (Elemento hijo):
{ hidden: { opacity: 0, y: 20 }, show: { opacity: 1, y: 0, transition: { duration: 0.5, ease: "easeOut" } } }
3. Lista de Verificación del Flujo de Trabajo
- Copia las instrucciones.
- Confirma si Lenis está instalado/configurado. Si no, configúralo primero.
- Aplica revelaciones estándar con desplazamiento hacia arriba al contenido de texto.
- Añade parallax a los activos multimedia grandes (imágenes/fondos de video).
- Añade revelaciones escalonadas a listas/grids.
- Construye el proyecto para verificar que no haya errores de TypeScript o de versiones incompatibles de Framer Motion.
- Dile al usuario: "خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف."