Que fait GSAP ?
Aperçu
GSAP (GreenSock Animation Platform) est la bibliothèque d'animation web la plus puissante. Elle gère les timelines complexes, les animations pilotées par le défilement, le morphing SVG, les effets de texte et les mouvements basés sur la physique. Utilisée par Apple, Google et Nike pour les pages d'accueil et les vitrines de produits. Gratuite pour la plupart des usages.
Instructions
Étape 1 : Animations de base
import gsap from 'gsap'
// Animer vers
Animations de base
import gsap from 'gsap'
// Animer vers une cible
gsap.to('.hero-title', { opacity: 1, y: 0, duration: 1, ease: 'power3.out' })
// Animer depuis un état
gsap.from('.card', { opacity: 0, y: 50, duration: 0.8, stagger: 0.15 })
// Définir instantanément
gsap.set('.hidden-element', { opacity: 0, y: 20 })
Étape 2 : Timelines
// Animations séquencées — jouer dans l'ordre
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') // chevauchement de 0.3s
.from('.hero-text', { opacity: 0, x: -50 })
.from('.cta-button', { opacity: 0, scale: 0.8 }, '<') // commence en même temps que le précédent
// Contrôle
tl.play()
tl.reverse()
tl.pause()
tl.seek(1.5) // sauter à 1.5 secondes
Étape 3 : ScrollTrigger
import { ScrollTrigger } from 'gsap/ScrollTrigger'
gsap.registerPlugin(ScrollTrigger)
// Animer lors du défilement dans la vue
gsap.from('.feature-section', {
scrollTrigger: {
trigger: '.feature-section',
start: 'top 80%', // déclencher lorsque le haut de l'élément atteint 80% de la fenêtre
end: 'bottom 20%',
toggleActions: 'play none none reverse', // onEnter, onLeave, onEnterBack, onLeaveBack
},
opacity: 0,
y: 100,
duration: 1,
})
// Épingler une section pendant le défilement
gsap.to('.horizontal-section', {
x: () => -(document.querySelector('.horizontal-section').scrollWidth - window.innerWidth),
scrollTrigger: {
trigger: '.horizontal-wrapper',
pin: true,
scrub: 1, // lissage progressif (1 seconde de décalage)
end: () => '+=' + document.querySelector('.horizontal-section').scrollWidth,
},
})
Étape 4 : Intégration 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">Carte 1</div>
<div className="card">Carte 2</div>
<div className="card">Carte 3</div>
</div>
)
}
Directives
- GSAP est gratuit pour les sites web publics. Les plugins commerciaux (MorphSVG, SplitText) nécessitent une licence.
- Utilisez le hook
useGSAPdans React — il gère automatiquement le nettoyage lors du démontage. - ScrollTrigger avec
scrubcrée des animations liées au défilement (parallaxe, progression). staggeranime plusieurs éléments séquentiellement — plus propre que les délais manuels.- GSAP surpasse les animations CSS pour les séquences complexes — basé sur requestAnimationFrame.