Emil Kowalski Animation Best Practices
Umfassender Animationsleitfaden für Weboberflächen basierend auf Emil Kowalskis Lehren, Open-Source-Bibliotheken (Sonner, Vaul) und seinem animations.dev Kurs. Enthält 43 Regeln in 7 Kategorien, priorisiert nach Wirkung.
Wann anwenden
Diese Richtlinien sollten herangezogen werden, wenn:
- Animationen zu React-Komponenten hinzugefügt werden
- Easing-Kurven oder Timing-Werte ausgewählt werden
- Gestenbasierte Interaktionen (Wischen, Ziehen) implementiert werden
- Toast-Benachrichtigungen oder Drawer-Komponenten erstellt werden
- Die Animationsleistung optimiert wird
- Die Barrierefreiheit von Animationen sichergestellt wird
Regelkategorien nach Priorität
| Priorität | Kategorie | Wirkung | Präfix |
|---|---|---|---|
| 1 | Easing-Auswahl | KRITISCH | ease- |
| 2 | Timing & Dauer | KRITISCH | timing- |
| 3 | Eigenschaftsauswahl | HOCH | props- |
| 4 | Transform-Techniken | HOCH | transform- |
| 5 | Interaktionsmuster | MITTEL-HOCH | interact- |
| 6 | Strategische Animation | MITTEL | strategy- |
| 7 | Barrierefreiheit & Feinschliff | MITTEL | polish- |
Kurzreferenz
1. Easing-Auswahl (KRITISCH)
ease-out-default– Verwende Ease-Out als Standard-Easingease-custom-curves– Verwende benutzerdefinierte Cubic-Bezier-Kurven anstelle von integrierten CSS-Kurvenease-in-out-onscreen– Verwende Ease-In-Out für Bewegungen auf dem Bildschirmease-spring-natural– Verwende Feder-Animationen für natürliche Bewegungenease-ios-drawer– Verwende iOS-artiges Easing für Drawer-Komponentenease-context-matters– Passe das Easing an den Animationskontext an
2. Timing & Dauer (KRITISCH)
timing-300ms-max– Halte UI-Animationen unter 300mstiming-faster-better– Schnellere Animationen verbessern die wahrgenommene Leistungtiming-asymmetric– Verwende asymmetrisches Timing für Drücken und Loslassentiming-tooltip-delay– Verzögere erste Tooltips, zeige nachfolgende sofort antiming-drawer-500ms– Verwende 500ms Dauer für Drawer-Animationen
3. Eigenschaftsauswahl (HOCH)
props-transform-opacity– Animiere nur transform und opacityprops-hardware-accelerated– Verwende hardwarebeschleunigte Animationen, wenn der Hauptthread ausgelastet istprops-will-change– Verwende will-change, um 1px-Verschiebungen zu verhindernprops-avoid-css-variables– Vermeide CSS-Variablen für Zieh-Animationenprops-clip-path-performant– Verwende clip-path für layoutfreie Enthüllungen
4. Transform-Techniken (HOCH)
transform-scale-097– Skaliere Buttons beim Drücken auf 0.97transform-never-scale-zero– Animiere niemals von scale(0)transform-percentage-translate– Verwende Prozentwerte für translateYtransform-origin-aware– Mache Animationen ursprungsbewussttransform-scale-children– Skalierungstransformationen wirken sich auf Kindelemente austransform-3d-preserve– Verwende preserve-3d für 3D-Transform-Effekte
5. Interaktionsmuster (MITTEL-HOCH)
interact-interruptible– Mache Animationen unterbrechbarinteract-momentum-dismiss– Verwende momentum-basiertes Verwerfeninteract-damping– Dämpfe das Ziehen an Grenzeninteract-scroll-drag-conflict– Löse Konflikte zwischen Scrollen und Zieheninteract-snap-points– Implementiere geschwindigkeitsbewusste Einrastpunkteinteract-friction-upward– Erlaube Ziehen nach oben mit Reibunginteract-pointer-capture– Verwende Zeigererfassung für Zieh-Operationen
6. Strategische Animation (MITTEL)
strategy-keyboard-no-animate– Animiere niemals Aktionen, die über die Tastatur ausgelöst wurdenstrategy-frequency-matters– Berücksichtige die Interaktionshäufigkeit vor dem Animierenstrategy-purpose-required– Jede Animation muss einen Zweck habenstrategy-feedback-immediate– Gib sofortiges Feedback auf alle Aktionenstrategy-marketing-exception– Marketing-Websites sind die Ausnahme
7. Barrierefreiheit & Feinschliff (MITTEL)
polish-reduced-motion– Respektiere prefers-reduced-motionpolish-opacity-fallback– Verwende Opazität als Fallback für reduzierte Bewegungpolish-framer-hook– Verwende den useReducedMotion-Hook in Framer Motionpolish-dont-remove-all– Entferne nicht alle Animationen für reduzierte Bewegungpolish-blur-bridge– Verwende Unschärfe, um Animationszustände zu überbrückenpolish-clip-path-tabs– Verwende clip-path für Tab-Übergängepolish-toast-stacking– Implementiere Toast-Stapelung mit Skalierung und Versatzpolish-scroll-reveal– Löse Scroll-Animationen bei geeignetem Schwellenwert auspolish-hover-gap-fill– Fülle Lücken zwischen hoverbaren Elementenpolish-stagger-children– Staffele Kind-Animationen für Orchestrierung
Referenz der Schlüsselwerte
| Wert | Verwendung |
|---|---|
cubic-bezier(0.32, 0.72, 0, 1) | iOS-artiges Drawer-/Sheet-Easing |
scale(0.97) | Button-Drück-Feedback |
scale(0.95) | Minimale Eingangsskalierung (niemals scale(0)) |
200ms ease-out | Standard-UI-Übergang |
300ms | Maximale Dauer für UI-Animationen |
500ms | Drawer-Animationsdauer |
0.11 px/ms | Geschwindigkeitsschwelle für Momentum-Verwerfen |
100px | Scroll-Enthüllungs-Viewport-Schwelle |
14px | Toast-Stapelabstand |
Referenzdateien
| Datei | Beschreibung |
|---|---|
| references/_sections.md | Kategoriendefinitionen und -reihenfolge |
| assets/templates/_template.md | Vorlage für neue Regeln |
| metadata.json | Versions- und Referenzinformationen |