Skill de Animações Avançadas de Rolagem
Quando usar este skill
- Quando o skill
tier-based-architecturesolicitar um site de nível "Premium 2D" ou superior. - Quando o usuário pedir que elementos apareçam gradualmente, deslizem para cima, escalem ou fixem conforme a rolagem da página.
- Ao construir uma landing page focada em storytelling (ex.: revelações de produtos no estilo Apple).
Diretrizes de Tom e Linguagem (Crítico)
- Sempre se comunique com o usuário no dialeto local jordaniano/palestino (اللهجة الأردنية والفلسطينية).
- Seja profissional, mas acessível: "يا هلا", "رتبتلك السكرول", "الأنيميشن صار جاهز".
- Explique as escolhas técnicas naturalmente em árabe misturado com termos web em inglês: "رح نستخدم
Framer Motionعشان حركات السكرول تطلع Smooth".
1. Configuração e Fundamentos
Se essas bibliotecas estiverem faltando, instale-as: @studio-freight/lenis (para base de rolagem suave) e framer-motion (para animações em nível de componente).
Configuração de Rolagem Suave com Lenis
Todo site que usa este skill deve ter uma base de rolagem suave para garantir que as animações pareçam premium.
- Configure o
Lenisem um componente de alto nível (ex.:SmoothScrollProvider.tsxoulayout.tsx).
// Exemplo de Configuração 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. Padrões de Animação (Framer Motion)
Ao construir seções, use os seguintes padrões para um acabamento de alto nível:
A. O "Fade Up Reveal"
Use isso para títulos e blocos de texto grandes ao entrarem na viewport.
- Hook:
useInViewou<motion.div whileInView={...} viewport={{ once: true, margin: "-10%" }}> - Estado Inicial:
opacity: 0, y: 40 - Estado Animado:
opacity: 1, y: 0 - Transição:
duration: 0.8, ease: [0.16, 1, 0.3, 1](easing personalizado é crucial para um toque premium).
B. A "Imagem Parallax"
Imagens devem se mover ligeiramente mais devagar ou mais rápido que a posição de rolagem.
- Hook:
useScrolleuseTransform. - Implementação:
const { scrollYProgress } = useScroll({ target: containerRef, offset: ["start end", "end start"] });
const y = useTransform(scrollYProgress, [0, 1], ["-20%", "20%"]);
- Envolva a imagem em um contêiner com
overflow-hiddene aplique a transformaçãoyaomotion.imginterno.
C. A "Lista Escalonada"
Para grades de recursos, membros da equipe ou cartões de preço.
- Pai:
<motion.div variants={containerVariants} initial="hidden" whileInView="show" viewport={{ once: true }}> - Variants (Pai):
{ hidden: { opacity: 0 }, show: { opacity: 1, transition: { staggerChildren: 0.1 } } } - Variants (Item Filho):
{ hidden: { opacity: 0, y: 20 }, show: { opacity: 1, y: 0, transition: { duration: 0.5, ease: "easeOut" } } }
3. Checklist do Fluxo de Trabalho
- Copie as instruções.
- Confirme se o Lenis está instalado/configurado. Caso contrário, configure-o primeiro.
- Aplique revelações Fade Up padrão ao conteúdo de texto.
- Adicione parallax a grandes ativos de mídia (imagens/vídeos de fundo).
- Adicione revelações escalonadas a listas/grades.
- Compile o projeto para verificar se não há erros de incompatibilidade de versão do TypeScript ou Framer Motion.
- Diga ao usuário: "خلصت يا سيدي.. ضفتلك حركات السكرول والـ Lenis، جرب اعمل سكرول بالصفحة وشوف كيف النعومة والشغل النظيف."