Que fait Bonnes pratiques d'animations GSAP ?
Guide complet pour implémenter des animations professionnelles, accessibles et performantes avec GSAP (GreenSock Animation Platform).
Principes fondamentaux
1. Performance avant tout
- Animer uniquement
transformetopacity(accéléré par GPU) - Éviter d'animer
width,height,top,left,margin,padding - Utiliser
will-changeavec parcimonie - Viser 60 ips sur tous les appareils
2. Accessibilité toujours
- Respecter
prefers-reduced-motion - S'assurer que le contenu est visible sans JavaScript
- Ne pas cacher le contenu critique derrière des animations
- Fournir des contrôles de saut/pause pour les animations longues
3. Amélioration progressive
- Le contenu doit fonctionner sans animations
- Les animations améliorent, ne remplacent pas, la fonctionnalité
- Tester avec les animations désactivées
Configuration GSAP
Installation
<!-- CDN (recommandé pour WordPress) -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollTrigger.min.js"></script>
<!-- Plugins optionnels -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollSmoother.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/SplitText.min.js"></script>
File d'attente WordPress
function theme_enqueue_gsap() {
// GSAP Core
wp_enqueue_script(
'gsap',
'https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js',
array(),
'3.12.5',
true
);
// ScrollTrigger
wp_enqueue_script(
'gsap-scrolltrigger',
'https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollTrigger.min.js',
array('gsap'),
'3.12.5',
true
);
// Animations du thème
wp_enqueue_script(
'theme-animations',
get_theme_file_uri('/assets/js/animations.js'),
array('gsap', 'gsap-scrolltrigger'),
filemtime(get_theme_file_path('/assets/js/animations.js')),
true
);
}
add_action('wp_enqueue_scripts', 'theme_enqueue_gsap');
Schémas d'animation
1. Apparition au scroll
// Apparition basique
gsap.from('.fade-in', {
opacity: 0,
y: 50,
duration: 1,
stagger: 0.2,
scrollTrigger: {
trigger: '.fade-in',
start: 'top 80%',
toggleActions: 'play none none none'
}
});
2. Éléments en cascade
// Cartes apparaissant une par une
gsap.from('.card', {
opacity: 0,
y: 100,
duration: 0.8,
stagger: {
amount: 0.6,
from: 'start'
},
ease: 'power2.out',
scrollTrigger: {
trigger: '.cards-container',
start: 'top 75%'
}
});
3. Effet parallaxe
// Parallaxe subtile sur les images
gsap.to('.parallax-image', {
yPercent: -20,
ease: 'none',
scrollTrigger: {
trigger: '.parallax-section',
start: 'top bottom',
end: 'bottom top',
scrub: true
}
});
4. Dévoilement de texte (ligne par ligne)
// Nécessite le plugin SplitText (Club GreenSock)
// Ou utilisez l'alternative CSS ci-dessous
// Alternative CSS - enroulez chaque ligne dans un span
gsap.from('.reveal-line', {
opacity: 0,
y: '100%',
duration: 0.8,
stagger: 0.1,
ease: 'power3.out',
scrollTrigger: {
trigger: '.text-reveal',
start: 'top 80%'
}
});
5. Dévoilement par rideau/masque
// Image dévoilée par un masque coulissant
gsap.to('.curtain-mask', {
scaleX: 0,
transformOrigin: 'right center',
duration: 1.2,
ease: 'power4.inOut',
scrollTrigger: {
trigger: '.curtain-container',
start: 'top 70%'
}
});
6. Timeline d'animation Héro
// Séquence héro complexe
const heroTL = gsap.timeline({
defaults: { ease: 'power3.out' }
});
heroTL
.from('.hero-bg', { scale: 1.2, duration: 1.5 })
.from('.hero-title', { opacity: 0, y: 100, duration: 1 }, '-=1')
.from('.hero-subtitle', { opacity: 0, y: 50, duration: 0.8 }, '-=0.5')
.from('.hero-cta', { opacity: 0, y: 30, duration: 0.6 }, '-=0.3');
Accessibilité
Respecter le mouvement réduit
// Vérifier la préférence utilisateur
const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
// Option 1 : Désactiver toutes les animations
if (prefersReducedMotion) {
gsap.globalTimeline.timeScale(0);
ScrollTrigger.getAll().forEach(st => st.kill());
}
// Option 2 : Animations simplifiées
const animationConfig = prefersReducedMotion
? { duration: 0, stagger: 0 }
: { duration: 1, stagger: 0.2 };
gsap.from('.element', {
opacity: 0,
y: prefersReducedMotion ? 0 : 50,
...animationConfig
});
Solution de repli CSS
/* S'assurer que le contenu est visible sans JS */
.fade-in {
opacity: 1;
transform: translateY(0);
}
/* Cacher uniquement si les animations doivent s'exécuter */
.js .fade-in {
opacity: 0;
transform: translateY(50px);
}
/* Respecter le mouvement réduit en CSS aussi */
@media (prefers-reduced-motion: reduce) {
.js .fade-in {
opacity: 1;
transform: none;
}
}
Ajouter une classe JS au HTML
// Ajouter au début du script
document.documentElement.classList.add('js');
Animations responsives
Animations adaptatives aux points de rupture
// Créer des animations responsives
const mm = gsap.matchMedia();
mm.add('(min-width: 1024px)', () => {
// Animations de bureau
gsap.from('.hero-image', {
x: 100,
opacity: 0,
duration: 1.2
});
return () => {
// Nettoyage lors du changement de point de rupture
};
});
mm.add('(max-width: 1023px)', () => {
// Animations mobiles (plus simples)
gsap.from('.hero-image', {
opacity: 0,
duration: 0.8
});
});
Rafraîchir au redimensionnement
// Recalculer ScrollTrigger au redimensionnement
let resizeTimer;
window.addEventListener('resize', () => {
clearTimeout(resizeTimer);
resizeTimer = setTimeout(() => {
ScrollTrigger.refresh();
}, 250);
});
Optimisation des performances
1. Utiliser uniquement les propriétés de transformation
// BON - Accéléré par GPU
gsap.to('.element', {
x: 100, // transform: translateX
y: 50, // transform: translateY
rotation: 45, // transform: rotate
scale: 1.2, // transform: scale
opacity: 0.5
});
// MAUVAIS - Provoque layout/paint
gsap.to('.element', {
left: 100, // Déclenche layout
width: '200px', // Déclenche layout
marginTop: 50 // Déclenche layout
});
2. Regrouper les animations similaires
// Utiliser batch pour plusieurs éléments similaires
ScrollTrigger.batch('.card', {
onEnter: batch => gsap.to(batch, {
opacity: 1,
y: 0,
stagger: 0.1
}),
start: 'top 85%'
});
3. Désactiver les ScrollTriggers inutilisés
// Nettoyage lors de la navigation (SPA) ou du démontage de composant
function cleanup() {
ScrollTrigger.getAll().forEach(st => st.kill());
gsap.killTweensOf('*');
}
4. Initialisation paresseuse
// Initialiser uniquement les animations des sections visibles
const observer = new IntersectionObserver((entries) => {
entries.forEach(entry => {
if (entry.isIntersecting) {
initSectionAnimations(entry.target);
observer.unobserve(entry.target);
}
});
}, { rootMargin: '100px' });
document.querySelectorAll('.animated-section').forEach(section => {
observer.observe(section);
});
Bonnes pratiques ScrollTrigger
1. Points de début/fin appropriés
// Éviter les erreurs courantes
ScrollTrigger.create({
trigger: '.section',
start: 'top 80%', // Quand le haut du déclencheur atteint 80% du haut de la fenêtre
end: 'bottom 20%', // Quand le bas du déclencheur atteint 20% du haut
markers: true, // Débogage uniquement - supprimer en production !
});
2. Épingler les sections avec précaution
// L'épinglage peut causer des problèmes de mise en page
ScrollTrigger.create({
trigger: '.pinned-section',
start: 'top top',
end: '+=100%',
pin: true,
pinSpacing: true, // Généralement souhaitable
anticipatePin: 1 // Aide sur mobile
});
3. Gérer le chargement des images
// Attendre les images avant de calculer les positions
ScrollTrigger.config({
ignoreMobileResize: true
});
window.addEventListener('load', () => {
ScrollTrigger.refresh();
});
// Ou rafraîchir après le chargement des images paresseuses
document.querySelectorAll('img[loading="lazy"]').forEach(img => {
img.addEventListener('load', () => ScrollTrigger.refresh());
});
Intégration des tests
Compatibilité QA visuelle
Pour que le skill visual-qa puisse capturer correctement les animations :
// Exposer une fonction pour compléter toutes les animations instantanément
window.completeAllAnimations = function() {
gsap.globalTimeline.progress(1);
ScrollTrigger.getAll().forEach(st => {
st.scroll(st.end);
});
};
// Ou ignorer complètement les animations pour les captures d'écran
if (window.location.search.includes('skip-animations')) {
gsap.globalTimeline.timeScale(100);
}
Tests Playwright
// Dans un test Playwright
await page.evaluate(() => {
if (window.completeAllAnimations) {
window.completeAllAnimations();
}
});
await page.waitForTimeout(500);
await page.screenshot({ path: 'screenshot.png', fullPage: true });
Bibliothèque d'animations commune
Classes d'animations réutilisables
// animations.js - Bibliothèque d'animations réutilisables
const Animations = {
// Initialiser toutes les animations
init() {
if (window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
return;
}
this.fadeIn();
this.slideIn();
this.parallax();
this.textReveal();
},
fadeIn() {
gsap.utils.toArray('[data-animate="fade-in"]').forEach(el => {
gsap.from(el, {
opacity: 0,
y: 50,
duration: 0.8,
scrollTrigger: {
trigger: el,
start: 'top 85%',
once: true
}
});
});
},
slideIn() {
gsap.utils.toArray('[data-animate="slide-left"]').forEach(el => {
gsap.from(el, {
opacity: 0,
x: -100,
duration: 1,
scrollTrigger: {
trigger: el,
start: 'top 80%',
once: true
}
});
});
gsap.utils.toArray('[data-animate="slide-right"]').forEach(el => {
gsap.from(el, {
opacity: 0,
x: 100,
duration: 1,
scrollTrigger: {
trigger: el,
start: 'top 80%',
once: true
}
});
});
},
parallax() {
gsap.utils.toArray('[data-parallax]').forEach(el => {
const speed = el.dataset.parallax || 0.2;
gsap.to(el, {
yPercent: -100 * speed,
ease: 'none',
scrollTrigger: {
trigger: el.parentElement,
start: 'top bottom',
end: 'bottom top',
scrub: true
}
});
});
},
textReveal() {
gsap.utils.toArray('[data-animate="text-reveal"]').forEach(el => {
const lines = el.querySelectorAll('.line');
gsap.from(lines, {
opacity: 0,
y: '100%',
duration: 0.8,
stagger: 0.1,
scrollTrigger: {
trigger: el,
start: 'top 80%',
once: true
}
});
});
},
// Rafraîchir après du contenu dynamique
refresh() {
ScrollTrigger.refresh();
},
// Nettoyage pour la navigation SPA
destroy() {
ScrollTrigger.getAll().forEach(st => st.kill());
gsap.killTweensOf('*');
}
};
// Initialiser au DOM prêt
document.addEventListener('DOMContentLoaded', () => Animations.init());
Utilisation HTML
<!-- Apparition -->
<div data-animate="fade-in">Contenu</div>
<!-- Glissement depuis la gauche -->
<div data-animate="slide-left">Contenu</div>
<!-- Parallaxe (0.2 = 20% de vitesse) -->
<img data-parallax="0.3" src="image.jpg">
<!-- Dévoilement de texte (nécessite enveloppe de lignes) -->
<div data-animate="text-reveal">
<div class="line">Première ligne</div>
<div class="line">Deuxième ligne</div>
</div>
Débogage
Activer les marqueurs
ScrollTrigger.defaults({
markers: true // Affiche les marqueurs de début/fin
});
Journaliser les événements d'animation
gsap.to('.element', {
x: 100,
onStart: () => console.log('Animation démarrée'),
onComplete: () => console.log('Animation terminée'),
onUpdate: self => console.log('Progression :', self.progress())
});
Vérifier les problèmes
// Lister tous les ScrollTriggers
console.log('ScrollTriggers:', ScrollTrigger.getAll());
// Vérifier si un élément existe
const el = document.querySelector('.animated-element');
if (!el) console.warn('Cible d\'animation non trouvée !');
Liste de vérification
Avant le lancement
- Supprimer tous les
markers: true - Tester avec
prefers-reduced-motion: reduce - Tester sur appareils mobiles (appareils réels, pas seulement DevTools)
- Vérifier les performances dans l'onglet Performance de DevTools
- Vérifier 60 ips sur les appareils cibles
- Contenu visible sans JavaScript
- Images chargées en différé avant le rafraîchissement ScrollTrigger
- Pas de thrashing de layout (éviter d'animer les propriétés de layout)
Intégration QA visuelle
- Animations terminées avant les captures d'écran
- Le défilement de la page entière déclenche toutes les animations
- Les captures d'écran capturent l'état animé final
- Tester à toutes les tailles de fenêtre
