GSAP
Visão Geral
GSAP (GreenSock Animation Platform) é a biblioteca de animação web mais poderosa. Lida com timelines complexas, animações orientadas por scroll, morphing SVG, efeitos de texto e movimento baseado em física. Usada pela Apple, Google e Nike para landing pages e vitrines de produtos. Gratuita para a maioria dos usos.
Instruções
Passo 1: Animações Básicas
import gsap from 'gsap'
// Animar para
gsap.to('.hero-title', { opacity: 1, y: 0, duration: 1, ease: 'power3.out' })
// Animar de
gsap.from('.card', { opacity: 0, y: 50, duration: 0.8, stagger: 0.15 })
// Definir imediatamente
gsap.set('.hidden-element', { opacity: 0, y: 20 })
Passo 2: Timelines
// Animações sequenciadas — executam em ordem
const tl = gsap.timeline({ defaults: { duration: 0.6, ease: 'power2.out' } })
tl.from('.logo', { scale: 0, rotation: -180 })
.from('.nav-link', { opacity: 0, y: -20, stagger: 0.1 }, '-=0.3') // sobreposição de 0.3s
.from('.hero-text', { opacity: 0, x: -50 })
.from('.cta-button', { opacity: 0, scale: 0.8 }, '<') // começa ao mesmo tempo que o anterior
// Controle
tl.play()
tl.reverse()
tl.pause()
tl.seek(1.5) // salta para 1.5 segundos
Passo 3: ScrollTrigger
import { ScrollTrigger } from 'gsap/ScrollTrigger'
gsap.registerPlugin(ScrollTrigger)
// Animar quando entrar na viewport durante o scroll
gsap.from('.feature-section', {
scrollTrigger: {
trigger: '.feature-section',
start: 'top 80%', // dispara quando o topo do elemento atinge 80% da viewport
end: 'bottom 20%',
toggleActions: 'play none none reverse', // onEnter, onLeave, onEnterBack, onLeaveBack
},
opacity: 0,
y: 100,
duration: 1,
})
// Fixar seção durante o scroll
gsap.to('.horizontal-section', {
x: () => -(document.querySelector('.horizontal-section').scrollWidth - window.innerWidth),
scrollTrigger: {
trigger: '.horizontal-wrapper',
pin: true,
scrub: 1, // escorregamento suave (1 segundo de atraso)
end: () => '+=' + document.querySelector('.horizontal-section').scrollWidth,
},
})
Passo 4: Integração com React
import { useRef } from 'react'
import { useGSAP } from '@gsap/react'
import gsap from 'gsap'
function AnimatedSection() {
const container = useRef(null)
useGSAP(() => {
gsap.from('.card', {
opacity: 0, y: 40, stagger: 0.1, duration: 0.6,
scrollTrigger: { trigger: container.current, start: 'top 80%' },
})
}, { scope: container })
return (
<div ref={container}>
<div className="card">Card 1</div>
<div className="card">Card 2</div>
<div className="card">Card 3</div>
</div>
)
}
Diretrizes
- GSAP é gratuito para sites públicos. Plug-ins comerciais (MorphSVG, SplitText) exigem licença.
- Use o hook
useGSAPno React — ele gerencia a limpeza automaticamente no desmonte. - ScrollTrigger com
scrubcria animações vinculadas ao scroll (parallax, progresso). staggeranima múltiplos elementos sequencialmente — mais limpo que atrasos manuais.- GSAP supera animações CSS para sequências complexas — baseado em requestAnimationFrame.