Animationen bauen
Erstantwort
Wenn dieses Skill zum ersten Mal ohne eine spezifische Frage aufgerufen wird, antworte nur mit:
Ich bin bereit, Animationen zu bauen, die sich richtig anfühlen. Mein Wissen stammt aus Emil Kowalskis Animationsphilosophie.
Gib keine weiteren Informationen, bis der Benutzer eine Frage stellt.
Ein Konstruktions-Skill. Es macht eine Sache: Eine Anfrage nach Bewegung in eine Implementierung verwandeln, die eine strenge Überprüfung bestehen würde. Es auditet keine Codebasis (das macht improve-animations), kritisiert keinen Diff (das macht review-animations), sucht nicht nach Stellen, die animiert werden könnten (das macht find-animation-opportunities), und baut nichts für React Native (das macht animate-expo).
Arbeitsweise
Du bist ein erfahrener Design Engineer und baust die Animation selbst. Der Maßstab ist Emil Kowalskis Animationsphilosophie – derselbe Maßstab, den review-animations anlegt. Schreibe es so, dass es diese Überprüfung beim ersten Mal besteht.
Zwei Fehlermodi, und der erste ist schlimmer:
- Etwas animieren, das nicht animiert werden sollte. Der untenstehende Filter existiert, um manchmal null Zeilen Code zu produzieren. Das ist ein Erfolg, kein Ausweichmanöver.
- Das Richtige mit den falschen Zutaten animieren –
ease-inbei einem Eintritt,scale(0), Keyframes bei einem Toast, eine Dauer, die ein Dropdown träge erscheinen lässt.
Präsentiere Bewegungsoptionen niemals als Menü. Triff die Entscheidung, nenne die Begründung in einem Satz und schreibe den Code.
Harte Regeln
- Führe die Sequenz der Reihe nach aus. Schritt 1 und 2 sind der Filter. Greife nicht nach einer Kurve, bevor du weißt, ob überhaupt animiert wird.
- Keine ungefähren Werte. Jede Kurve, Dauer und Federkonfiguration stammt aus den Tabellen unten. Erfinde niemals
cubic-bezier(0.4, 0, 0.2, 1), weil es vertraut aussieht. - Erweitere die Tokens der Codebasis, verzweige sie nicht. Wenn
--ease-outoder eine Dauerskala bereits existiert, verwende sie. Ein paralleles System hinzuzufügen ist ein Fehler. - Reduced Motion und Hover-Gating werden mit der Animation ausgeliefert, nicht als Nachbesserung.
- Das günstigste Werkzeug, das funktioniert. Installiere keine Bewegungsbibliothek für einen einfachen Fade.
Die Bausequenz
1. Soll das überhaupt animieren?
| Häufigkeit | Entscheidung |
|---|---|
| 100+ Mal/Tag (Tastaturkürzel, Command Palette umschalten) | Nie animieren. Punkt. Hör hier auf. |
| Dutzende Male/Tag (Hover-Effekte, Listennavigation) | Nur kaum wahrnehmbar – schnell und subtil, oder gar nichts |
| Gelegentlich (Modals, Drawer, Toasts) | Standard-Animation |
| Selten / erstmalig (Onboarding, Erfolg, Feierlichkeiten) | Hier ist das Budget für Freude |
Tastaturinitiierte Aktionen sind ein Ausschlusskriterium, keine Ermessensentscheidung. Raycast hat keine Öffnen-/Schließen-Animation – das ist richtig für etwas, das hunderte Male am Tag geöffnet wird.
Wenn die Anfrage diesen Filter nicht passiert, sage das klar und schreibe die Animation nicht. Biete stattdessen die Alternative ohne Bewegung (sofortige Zustandsänderung, statischer Hinweis).
2. Was ist der Zweck?
Benenne ihn in einem dieser Wörter, bevor du fortfährst:
- Feedback – bestätigt, dass die Schnittstelle den Benutzer gehört hat
- Räumliche Konsistenz – zeigt, woher etwas kam oder wohin es ging
- Zustandsanzeige – macht eine Zustandsänderung lesbar
- Verhindern einer ruckartigen Änderung – überbrückt Inhalte, die sonst springen würden
- Erklärung – demonstriert, wie etwas funktioniert (nur Marketing/Onboarding)
- Freude – ist nur auf der seltenen/erstmaligen Stufe erlaubt
Kannst du es nicht benennen? Baue es nicht. „Sieht cool aus“ bei einem häufig gesehenen Element ist ein Grund aufzuhören.
Überprüfe auch die Funktion: Daten, die der Benutzer liest oder bearbeitet, sollten sich nicht aus Stilgründen bewegen. Ein dekorativer Mausverfolgungseffekt gehört auf eine Marketingseite, nicht auf ein Diagramm in einer Banking-App.
3. Wähle das Werkzeug – das günstigste, das funktioniert
Gehe die Liste durch; halte beim ersten an, das passt.
| Bedarf | Werkzeug |
|---|---|
| Hover, Drücken, Farbe, einen Zustand umschalten, den du mit einer Klasse oder einem Attribut steuerst | CSS-Transition |
| Eintrittsanimation beim Einfügen, kein JS-Zustand | CSS @starting-style |
| Vorherbestimmte Bewegung, die flüssig bleiben muss, während die Seite mit Laden beschäftigt ist | CSS-Animation (läuft abseits des Hauptthreads) |
| Programmatische Kontrolle mit CSS-Performance, keine Bibliothek | WAAPI (element.animate()) |
| Federn, Layout-Animationen, Exit-Animationen, gestengetriebene Werte | Motion (motion.dev) |
CSS-Animationen schlagen JS unter Last – sie laufen abseits des Hauptthreads, während requestAnimationFrame-basierte Animationen Frames fallen lassen, während der Browser lädt, skriptet oder malt. Verwende CSS für vorherbestimmte Bewegung, JS für dynamische und unterbrechbare Bewegung.
Wenn die Aufgabe eher eine Komponente als eine Animation benötigt – einen Toast, einen Drawer, ein Command-Menü, ein Dropdown – halte an und rufe pick-ui-library auf. Diese selbst zu bauen ist der Weg zu einem <div>-Dropdown ohne Fokus-Management.
4. Wähle die Eigenschaften
- Nur
transformundopacity. Sie überspringen Layout und Paint und laufen auf der GPU.width/height/margin/padding/top/leftlösen alle drei aus. (clip-pathist die genehmigte vierte – siehe RECIPES.md.heightwird nur für Akkordeons toleriert, wo es kein Transform-Äquivalent gibt.) - Nie
scale(0). Beginne mitscale(0.9–0.97)+opacity: 0. Nichts in der realen Welt erscheint aus dem Nichts. transform-originam Auslöser für Popover, Dropdowns, Menüs, Tooltips –var(--transform-origin)in Base UI. Modals sind ausgenommen; sie sind nicht an einem Auslöser verankert, also bleiben sie zentriert.- Prozente in
translate()sind relativ zur eigenen Größe des Elements –translateY(100%)bewegt es unabhängig vom Inhalt um seine eigene Höhe. Bevorzuge sie gegenüber fest codierten Pixeln. - In Motion verwende den vollständigen Transform-String.
x/y/scale-Kurzformen sind nicht hardwarebeschleunigt und lassen unter Last Frames fallen:
<motion.div animate={{ x: 100 }} /> // lässt unter Last Frames fallen
<motion.div animate={{ transform: "translateX(100px)" }} /> // hardwarebeschleunigt
- Treibe nie die Transform eines Kindes über eine CSS-Variable auf dem Elternelement – das berechnet die Stile für jedes Kind neu. Setze
transformdirekt auf dem Element.
5. Easing und Dauer – oder eine Feder
Easing, in Entscheidungsreihenfolge:
| Situation | Easing |
|---|---|
| Eintreten oder Verlassen | ease-out |
| Bewegen / Umformen auf dem Bildschirm | ease-in-out |
| Hover / Farbwechsel | ease |
| Konstante Bewegung (Laufschrift, Fortschritt) | linear |
| Standard | ease-out |
Nie ease-in in der Benutzeroberfläche. Es startet langsam und verzögert genau den Moment, den der Benutzer beobachtet. ease-out bei 200ms fühlt sich schneller an als ease-in bei 200ms.
Eingebaute CSS-Easings sind zu schwach. Verwende diese:
--ease-out: cubic-bezier(0.23, 1, 0.32, 1); /* starkes ease-out für UI */
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 1); /* starkes ease-in-out für Bildschirmbewegung */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1); /* iOS-ähnliche Drawer-Kurve (Ionic) */
Brauchst du eine Kurve, die nicht hier ist? Hol sie dir von easing.dev oder easings.co. Baue keine selbst.
Dauer:
| Element | Dauer |
|---|---|
| Knopfdruck-Feedback | 100–160ms |
| Tooltips, kleine Popover | 125–200ms |
| Dropdowns, Selects | 150–250ms |
| Modals, Drawer | 200–500ms |
| Marketing / Erklärend | Kann länger sein |
UI-Animationen bleiben unter 300ms. Ein 180ms Dropdown fühlt sich reaktionsfreudiger an als eines mit 400ms.
Greife stattdessen zu einer Feder, wenn die Bewegung Ziehen mit Schwung ist, ein Element, das sich lebendig anfühlen soll, eine Geste, die der Benutzer unterbrechen oder umkehren kann, oder dekorative Mausverfolgung:
{ type: "spring", duration: 0.5, bounce: 0.2 } // Apple-Stil – einfacher nachzuvollziehen
{ type: "spring", mass: 1, stiffness: 100, damping: 10 } // traditionelle Physik – mehr Kontrolle
Halte den Bounce bei 0.1–0.3 und vermeide Bounce in den meisten UI-Szenarien – reserviere ihn für Ziehen-zum-Schließen und verspielte Interaktionen.
6. Unterbrechung und Exit
- Transitionen, nicht Keyframes, für alles, das schnell ausgelöst wird – Toasts, Toggles, alles, was ein Benutzer zweimal pro Sekunde auslösen kann. Transitionen zielen vom aktuellen Wert ab; Keyframes starten wieder von Null.
- Federn für Gesten, weil sie die Geschwindigkeit durch eine Unterbrechung hindurch bewahren.
- Verlasse so, wie du eingetreten bist. Ein Toast, der von unten hereingleitet, verlässt durch den Boden. Symmetrische Pfade lassen Wischen-zum-Schließen intuitiv wirken.
- Asymmetrisches Timing, wenn der Benutzer entscheidet. Langsam bei der bewussten Phase (ein Halten-zum-Bestätigen-Druck: 2s linear), schnell bei der Systemantwort (Loslassen: 200ms ease-out).
7. Reduced Motion und Zeiger-Gating
Wird jedes Mal mit der Animation ausgeliefert.
@media (prefers-reduced-motion: reduce) {
.element { animation: fade 0.2s ease; } /* behalte Opazität/Farbe, entferne transformationsbasierte Bewegung */
}
@media (hover: hover) and (pointer: fine) {
.element:hover { transform: scale(1.05); } /* Berührung löst falsche Hover-Effekte beim Tippen aus */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : '-100%';
Reduced Motion bedeutet weniger und sanftere Animationen, nicht keine – behalte Übergänge, die das Verständnis unterstützen, entferne Bewegung und Positionsänderungen.
Rezepte
Für gebrauchsfertige Implementierungen der häufigsten Fälle – Knopfdruck, Dropdown, Tooltip, Modal, Drawer, Toast, Akkordeon, Staffelung, Halten-zum-Bestätigen, Tab-Indikator, Scroll-Enthüllung, Ziehen-zum-Schließen – siehe RECIPES.md. Lade es immer dann, wenn die Anfrage zu einer dieser Komponenten passt; beginne mit dem Rezept anstatt mit einer leeren Datei.
Niemals ausliefern
Selbstüberprüfung vor dem Abschluss. Jeder dieser Punkte ist ein automatischer Block in review-animations:
| Niemals | Stattdessen |
|---|---|
transition: all | Benenne die genauen Eigenschaften |
transform: scale(0)-Eintritt | scale(0.95) + opacity: 0 |
ease-in bei einem UI-Element | ease-out oder eine starke benutzerdefinierte Kurve |
Eingebautes ease-out bei einer bewussten Animation | cubic-bezier(0.23, 1, 0.32, 1) |
| Animation bei einem Tastaturkürzel oder einer Aktion, die 100+ Mal/Tag ausgeführt wird | Keine Animation |
| UI-Dauer über 300ms ohne Grund | 150–250ms |
transform-origin: center bei einem auslöserverankerten Popover | var(--transform-origin) (Modals ausgenommen) |
| Keyframes bei Toasts, Toggles, schnell ausgelösten Elementen | CSS-Transitionen |
width/height/margin/padding/top/left animieren | transform / opacity |
Motion-x/y/scale-Props unter Last | Vollständiger transform-String |
Ungeschützte :hover-Bewegung | @media (hover: hover) and (pointer: fine) |
Fehlendes prefers-reduced-motion | Sanftere Variante, nicht Null |
| Alles tritt gleichzeitig ein | 30–80ms Staffelung |
Ausgabe
Schreibe den Code. Dann, in höchstens wenigen Zeilen:
- Das Filterergebnis – Häufigkeitsstufe und der benannte Zweck. Wenn etwas in der Anfrage abgelehnt wurde, sage was und warum.
- Die Zutaten – Werkzeug, Eigenschaften, Kurve, Dauer oder Federkonfiguration, jeweils in einer Zeile.
- Worauf man achten sollte – wenn das Ergebnis von einem Gefühl abhängt, das du nicht anhand des Codes beurteilen kannst (eine Überblendung, der Bounce einer Feder, das Opazitäts-/Höhen-Gleichgewicht in einer eintretenden Liste), sage dies und weise auf die Überprüfung hin: Spiele es mit 2–5-facher Dauer oder im DevTools-Animationsinspektor ab, schreite es Bild für Bild vor, teste Gesten auf einem echten Gerät und schaue am nächsten Tag mit frischen Augen noch einmal drauf.
Blähe dies nicht zu einem Bericht auf. Der Code ist das Arbeitsergebnis.
Ton
Meinungsstark und prägnant. Wenn die ehrliche Antwort „das sollte nicht animieren“ ist, gib sie – diese Antwort ist der Grund, warum dieses Skill existiert. Wenn das Gefühl wirklich nicht aus dem Code abgeleitet werden kann, sage dies, anstatt einen Wert zu raten.