Scroll motion
Le mouvement doit expliquer la structure : ce qui est nouveau, ce qui va ensemble, ce qu'il faut regarder ensuite. Une animation qui ne fait rien de tout cela est de la décoration et coûte de la performance. Chaque effet ci-dessous est donc lié à un objectif.
Configuration
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/lenis@1/dist/lenis.min.js"></script>
<script defer src="/js/main.js"></script>
defer empêche les scripts de bloquer le premier affichage et les exécute toujours dans l'ordre, donc main.js (le code ci-dessous) voit gsap. En production, fixez les versions exactes ([email protected]) ou hébergez les fichiers vous-même.
gsap.registerPlugin(ScrollTrigger);
const reduce = matchMedia("(prefers-reduced-motion: reduce)").matches;
if (!reduce) {
const lenis = new Lenis({ duration: 1.1, smoothWheel: true });
lenis.on("scroll", ScrollTrigger.update);
gsap.ticker.add((t) => lenis.raf(t * 1000));
gsap.ticker.lagSmoothing(0);
}
Enveloppez chaque animation dans if (!reduce) ou utilisez gsap.matchMedia(). Les personnes souffrant de troubles vestibulaires définissent cette préférence pour une bonne raison, et le contenu doit être entièrement visible sans mouvement.
Choisir un effet
| Objectif | Effet | Section de référence |
|---|---|---|
| Annoncer une nouvelle section | Révélation masquée du titre | Révélations |
| Montrer que des éléments vont ensemble | Apparition progressive échelonnée | Révélations |
| Ajouter de la profondeur aux images | Parallaxe, révélations par clip-path | Images |
| Raconter une séquence | Étapes épinglées, ligne tracée | Épinglage |
| Présenter une gamme de travaux | Défilement horizontal | Épinglage |
| Mettre en valeur un nombre | Compteur incrémental | Détails |
| Couvrir le chargement initial | Préchargeur | Détails |
Le code prêt à copier pour chacun se trouve dans references/snippets.md. Lisez-le lorsque vous êtes sur le point d'implémenter un effet ; vous n'en avez pas besoin pour planifier.
Règles de base
- Animer uniquement
transformetopacity. Animertop,width,marginoubox-shadowdéclenche une mise en page ou un repeint à chaque image et saccade sur les téléphones de milieu de gamme. - Durées : 0,6 à 1,0 s pour les révélations, 0,2 à 0,3 s pour les survols. Plus long semble lent lors de la deuxième visite.
- Easing :
power3.outpour les entrées,power2.inOutpour les transitions,nonepour les animations synchronisées au défilement (le scrub fournit l'easing). - Stagger : 0,06 à 0,12 s. Limitez le total : avec 12 cartes, échelonnez les 6 premières et regroupez les autres.
- Jouer une fois. Utilisez
once: trueoutoggleActions: "play none none none". Réanimer à chaque retour en arrière est fatiguant. - Une seule pièce maîtresse par page. Une section épinglée ou horizontale est mémorable une fois et épuisante trois fois.
- Définir l'état initial en JS, pas en CSS. Si le script ne se charge pas, le contenu masqué par CSS reste masqué pour toujours.
- Actualiser après les changements de mise en page : appelez
ScrollTrigger.refresh()après le chargement des polices et des images, sinon les positions des déclencheurs dérivent.
window.addEventListener("load", () => ScrollTrigger.refresh());
document.fonts?.ready.then(() => ScrollTrigger.refresh());
Mobile
- Désactivez l'épinglage et le défilement horizontal en dessous de 768 px avec
gsap.matchMedia(); empilez le contenu normalement. - Le défilement fluide de Lenis sur le tactile est souvent en conflit avec l'élan natif. Laissez le défilement tactile natif (par défaut) sauf si la personne insiste.
- Réduisez de moitié les distances de parallaxe sur les petits écrans.
Débogage
- Ajoutez
markers: trueà un ScrollTrigger pour voir les lignes de début et de fin. - Un saut au début d'un épingle signifie généralement que l'élément épinglé a un parent avec une transformation ou une hauteur variable.
- L'animation se déclenche trop tôt : des images au-dessus ont été chargées tardivement. Définissez des
widthetheightexplicites sur les images. - Rien ne s'anime : vérifiez que le plugin est enregistré et que le sélecteur correspond.
Sans GSAP
Pour de simples apparitions progressives sur un petit site, un IntersectionObserver ajoutant une classe avec une transition CSS suffit et économise environ 70 Ko. Voir la dernière section de references/snippets.md.