Scroll motion (Scroll-Bewegung)
Bewegung sollte die Struktur erklären: was neu ist, was zusammengehört, was als Nächstes zu sehen ist. Animation, die nichts davon tut, ist nur Dekoration und kostet Performance, daher ist jeder untenstehende Effekt an einen Zweck gebunden.
Einrichtung
<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 verhindert, dass die Skripte den ersten Seitenaufbau blockieren, und führt sie dennoch in der richtigen Reihenfolge aus, sodass main.js (der folgende Code) gsap sieht. Für die Produktion sollten genaue Versionen ([email protected]) angegeben oder die Dateien selbst gehostet werden.
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);
}
Jede Animation in if (!reduce) kapseln oder gsap.matchMedia() verwenden. Menschen mit Gleichgewichtsstörungen setzen diese Einstellung aus gutem Grund, und Inhalte müssen auch ohne Bewegung vollständig sichtbar sein.
Einen Effekt auswählen
| Zweck | Effekt | Referenzabschnitt |
|---|---|---|
| Einen neuen Abschnitt ankündigen | Maskierte Überschriften-Einblendung | Einblendungen |
| Zusammengehörigkeit zeigen | Gestaffeltes Einblenden von unten | Einblendungen |
| Bildern Tiefe verleihen | Parallaxe, Clip-Pfad-Einblendung | Bilder |
| Eine Abfolge erzählen | Fixierte Schritte, gezeichnete Linie | Fixierung |
| Eine Bandbreite an Arbeiten zeigen | Horizontaler Scroll | Fixierung |
| Eine Zahl hervorheben | Count-up | Details |
| Den initialen Ladevorgang abdecken | Preloader | Details |
Kopierfertiger Code für jeden Effekt befindet sich in references/snippets.md. Lies ihn, wenn du kurz davor bist, einen Effekt zu implementieren; für die Planung ist er nicht nötig.
Hausregeln
- Nur
transformundopacityanimieren. Das Animieren vontop,width,marginoderbox-shadowlöst bei jedem Frame Layout- oder Paint-Vorgänge aus und ruckelt auf Mittelklasse-Handys. - Dauern: 0,6 bis 1,0 s für Einblendungen, 0,2 bis 0,3 s für Hover. Längere Dauern wirken beim zweiten Besuch langsam.
- Easing:
power3.outfür Eintritte,power2.inOutfür Übergänge,nonefür scrubbede Animationen (scrub liefert das Easing). - Stagger: 0,06 bis 0,12 s. Begrenze die Gesamtzahl: Bei 12 Karten die ersten 6 staffeln und den Rest gemeinsam einblenden.
- Einmal abspielen. Verwende
once: trueodertoggleActions: "play none none none". Jedes Zurückscrollen erneut zu animieren, ist ermüdend. - Ein Prunkstück pro Seite. Ein fixierter oder horizontaler Abschnitt ist einmal einprägsam und dreimal anstrengend.
- Initialzustand in JS setzen, nicht in CSS. Wenn das Skript nicht lädt, bleiben CSS-versteckte Inhalte für immer verborgen.
- Nach Layout-Änderungen aktualisieren:
ScrollTrigger.refresh()aufrufen, nachdem Schriftarten und Bilder geladen wurden, sonst verschieben sich die Trigger-Positionen.
window.addEventListener("load", () => ScrollTrigger.refresh());
document.fonts?.ready.then(() => ScrollTrigger.refresh());
Mobilgeräte
- Fixierung und horizontalen Scroll unter 768px mit
gsap.matchMedia()deaktivieren; den Inhalt normal stapeln. - Lenis‘ weiches Scrollen auf Touch-Geräten kämpft oft mit dem nativen Momentum. Lass Touch-Scrollen (die Standardeinstellung) nativ, es sei denn, der Kunde besteht darauf.
- Parallax-Distanzen auf kleinen Bildschirmen halbieren.
Fehlersuche
markers: truezu einem ScrollTrigger hinzufügen, um Start- und Endlinien zu sehen.- Ein Sprung am Anfang einer Fixierung bedeutet meist, dass das fixierte Element ein transform-Elternteil oder eine sich ändernde Höhe hat.
- Animation wird zu früh ausgelöst: Bilder oberhalb wurden zu spät geladen. Setze explizite
widthundheightauf Bilder. - Nichts animiert: Überprüfe, ob das Plugin registriert ist und der Selektor passt.
Ohne GSAP
Für einfache Einblendungen von unten auf einer kleinen Website reicht ein IntersectionObserver, der eine Klasse hinzufügt, plus ein CSS-Übergang aus – das spart etwa 70 KB. Siehe den letzten Abschnitt von references/snippets.md.