Communitygithub.com

scroll-motion

Ajoute des animations au défilement et des animations d'entrée à un site web avec GSAP, ScrollTrigger et Lenis, incluant des révélations, des parallaxes, des sections épinglées, un défilement horizontal, le dessin de lignes, des compteurs et des préchargeurs.

Qu'est-ce que scroll-motion ?

Ce skill permet d'implémenter des animations de défilement sophistiquées et des animations d'entrée sur un site web, en utilisant les bibliothèques GSAP, ScrollTrigger et Lenis. Il couvre une large gamme d'effets : révélations de texte, parallaxes, sections épinglées, défilement horizontal, dessin de lignes, compteurs animés et préchargeurs. Chaque effet est associé à un objectif précis (annoncer une section, montrer une séquence, etc.), ce qui évite les animations purement décoratives qui nuisent aux performances. Le skill fournit des instructions de configuration détaillées, des règles de performance (animer uniquement `transform` et `opacity`, durées limitées, etc.), une section mobile, une section de débogage, et une alternative légère sans GSAP. Il insiste sur l'accessibilité en respectant le paramètre `prefers-reduced-motion: reduce` et sur le fait de jouer les animations une seule fois.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/main/skills/scroll-motion

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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

ObjectifEffetSection de référence
Annoncer une nouvelle sectionRévélation masquée du titreRévélations
Montrer que des éléments vont ensembleApparition progressive échelonnéeRévélations
Ajouter de la profondeur aux imagesParallaxe, révélations par clip-pathImages
Raconter une séquenceÉtapes épinglées, ligne tracéeÉpinglage
Présenter une gamme de travauxDéfilement horizontalÉpinglage
Mettre en valeur un nombreCompteur incrémentalDétails
Couvrir le chargement initialPréchargeurDé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 transform et opacity. Animer top, width, margin ou box-shadow dé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.out pour les entrées, power2.inOut pour les transitions, none pour 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: true ou toggleActions: "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 width et height explicites 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.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

Skills associés