Animationen erstellen
Dieses Repository (Asymmetric-al/core)
Verwende diesen Skill, um Web-Bewegungen nach den Design-Engineering- und operativen Motion-Verträgen von Core zu implementieren. Gleiche diesen Overlay nach Upstream-Aktualisierungen ab, bevor du bun run skills:sync ausführst.
Auslöser
- Erstellen oder Umschreiben einer Web-Animation, eines Übergangs oder einer Mikro-Interaktion.
- Nicht verwenden für Expo/React Native (
animate-expo), ein Codebase-Audit (improve-animations) oder eine reine Motion-Überprüfung (review-animations).
Arbeitsablauf
- Lade zuerst
docs/ai/skills/emil-design-engineering/SKILL.mdunddocs/ai/skills/anim/SKILL.md. - Verwende vorhandene Core-Motion-Tokens und Base-UI-Primitive wieder. Forke keine Dauern, Easings oder führe Radix-APIs ein.
- Behalte „reduced-motion“ auf der globalen Basislinie in
packages/ui/styles/globals.css. - Wenn die Aufgabe einen Toast, Drawer, ein Menü oder Dropdown benötigt, verwende
@asym/ui/ Base UI wieder. Rufepick-ui-librarynicht auf, es sei denn, der Benutzer hat explizit gefragt, welche Bibliothek verwendet werden soll.
Checkliste
- Die Animation hat einen Zweck und bleibt wo möglich bei transform/opacity.
- Core-Tokens, Base UI und
animhaben Vorrang vor veranschaulichenden Upstream-Werten. - Gemeinsame Dienstprogramme und
@asym/lib/motion-presetswerden neuen Zeitliteralen vorgezogen.
Ein Konstruktions-Skill. Er tut EINES: eine Anfrage nach Bewegung in eine Implementierung verwandeln, die eine strenge Überprüfung überstehen würde. Er auditieret keine Codebasis (das ist improve-animations), kritisiert keinen Diff (das ist review-animations), sucht nicht nach Stellen, die animieren könnten (das ist find-animation-opportunities), und erstellt nichts für React Native (das ist animate-expo).
Betriebshaltung
Du bist ein erfahrener Design-Ingenieur, der die Animation selbst erstellt. Die Messlatte ist Emil Kowalskis Animationsphilosophie – dieselbe Messlatte, die review-animations durchsetzt. Schreibe sie so, dass sie diese Überprüfung beim ersten Mal besteht.
Zwei Fehlermodi, und der erste ist schlimmer:
- Etwas animieren, das nicht animiert werden sollte. Die folgende Hürde existiert, um manchmal null Codezeilen zu produzieren. Das ist ein Erfolg, keine Ausrede.
- Das Richtige mit den falschen Zutaten animieren –
ease-inbei einem Eintritt,scale(0), Keyframes bei einem Toast, eine Dauer, die ein Dropdown träge wirken lässt.
Präsentiere Bewegungsoptionen niemals als Menü. Triff die Entscheidung, gib die Begründung in einem Satz an und schreibe den Code.
Harte Regeln
- Führe die Sequenz der Reihe nach aus. Schritte 1 und 2 sind die Hürde für alles. Greife nicht nach einer Kurve, bevor du weißt, ob es überhaupt animiert.
- Keine Näherungswerte. Jede Kurve, Dauer und Federkonfiguration stammt aus den folgenden Tabellen. Erfinde niemals
cubic-bezier(0.4, 0, 0.2, 1), weil es vertraut aussieht. - Erweitere die Tokens der Codebasis, forke sie nicht. Wenn
--ease-out-softoder ein Dauer-Token bereits inpackages/ui/styles/globals.cssexistiert, verwende es. Ein paralleles System hinzuzufügen ist ein Fehler. - Reduzierte Bewegung und Hover-Gating werden mit der Animation ausgeliefert, nicht als Nachbesserung.
- Das günstigste Werkzeug, das funktioniert. Installiere keine Motion-Bibliothek für ein Einblenden.
Die Erstellungssequenz
1. Soll das überhaupt animieren?
| Häufigkeit | Entscheidung |
|---|---|
| 100+ Mal/Tag (Tastaturkürzel, Befehlspalette umschalten) | Niemals animieren. Hier aufhören. |
| Dutzende Male/Tag (Hover-Effekte, Listennavigation) | Nur nahezu unmerklich – schnell und subtil, oder gar nicht |
| Gelegentlich (Modals, Drawer, Toasts) | Standardanimation |
| Selten / zum ersten Mal (Onboarding, Erfolg, Feier) | Das Vergnügungsbudget lebt hier |
Tastaturinitiierte Aktionen sind ein Ausschlusskriterium, keine Ermessensentscheidung. Raycast hat keine Öffnen/Schließen-Animation – das ist korrekt für etwas, das hunderte Male am Tag geöffnet wird.
Wenn die Anfrage diese Hürde nicht besteht, sage dies klar und schreibe die Animation nicht. Biete stattdessen die Alternative ohne Bewegung an (sofortige Zustandsänderung, ein statischer Hinweis).
2. Was ist der Zweck?
Benenne ihn in einem dieser Wörter, bevor du fortfährst:
- Feedback – Bestätigung, dass die Schnittstelle den Benutzer gehört hat
- Räumliche Konsistenz – Zeigen, woher etwas kam oder wohin es ging
- Zustandsanzeige – Eine Zustandsänderung lesbar machen
- Verhindern einer ruckartigen Änderung – Überbrücken von Inhalten, die sonst teleportieren würden
- Erklärung – Demonstrieren, wie etwas funktioniert (nur Marketing/Onboarding)
- Vergnügen – Nur auf der seltenen/zum-ersten-Mal-Stufe erlaubt
Kannst du ihn nicht benennen? Baue es nicht. „Es sieht cool aus“ auf einem häufig gesehenen Element ist ein Grund aufzuhören.
Überprüfe auch die Funktion: Daten, die der Benutzer liest oder mit denen er arbeitet, sollten sich nicht aus Stilgründen bewegen. Ein dekorativer Mausverfolgungseffekt gehört auf eine Marketingseite, nicht in ein Diagramm in einer Banking-App.
3. Wähle das Werkzeug – das günstigste, das funktioniert
Gehe die Liste durch; stoppe beim ersten, das passt.
| Bedarf | Werkzeug |
|---|---|
| Hover, Drücken, Farbe, ein Zustandsumschalter, den du mit einer Klasse oder einem Attribut steuerst | CSS-Übergang |
| Eintrittsanimation beim Mounten, kein JS-Zustand | CSS @starting-style |
| Vorherbestimmte Bewegung, die glatt bleiben muss, während die Seite lädt | CSS-Animation (läuft außerhalb des Hauptthreads) |
| Programmatische Steuerung mit CSS-Leistung, keine Bibliothek | WAAPI (element.animate()) |
| Federn, Layout-Animationen, Ausgangsanimationen, gestengesteuerte Werte | Motion (motion.dev) |
CSS-Animationen schlagen JS unter Last – sie laufen außerhalb des Hauptthreads, während requestAnimationFrame-basierte Animationen Bildraten verlieren, während der Browser lädt, Skripte ausführt oder malt. Verwende CSS für vorherbestimmte Bewegung, JS für dynamische und unterbrechbare Bewegung.
Wenn die Aufgabe eine Komponente und keine Animation benötigt – einen Toast, einen Drawer, ein Befehlsmenü, ein Dropdown – verwende @asym/ui und Base UI wieder. Rufe pick-ui-library nicht auf, es sei denn, der Benutzer hat explizit gefragt, welche Bibliothek verwendet werden soll. Eigenbau ist, wie man bei einem <div>-Dropdown ohne Fokusverwaltung landet.
4. Wähle die Eigenschaften
- Nur
transformundopacity. Sie überspringen Layout und Malen und laufen auf der GPU.width/height/margin/padding/top/leftlösen alle drei aus. (clip-pathist die sanktionierte vierte – siehe RECIPES.md.heightwird nur für Akkordeons toleriert, wo es kein Transform-Äquivalent gibt.) - Niemals
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 Popovers, Dropdowns, Menüs, Tooltips –var(--transform-origin)in Base UI. Modals sind ausgenommen; sie sind nicht an einem Auslöser verankert, bleiben also zentriert.- Prozentsätze in
translate()sind relativ zur eigenen Größe des Elements –translateY(100%)bewegt sich um seine eigene Höhe, unabhängig vom Inhalt. Bevorzuge sie gegenüber fest codierten Pixeln. - In Motion sind
x,yundscaleunterstützte unabhängige Transforms. Sie sind leistungsstark. Verwende einen vollständigentransform-String nur, wenn die Animation auf dem Compositor bleiben muss, während der Hauptthread beschäftigt ist:
<motion.div animate={{ x: 100 }} />
<motion.div animate={{ transform: "translateX(100px)" }} />
- Treibe niemals den Transform eines Kindes über eine CSS-Variable auf dem Elternteil – es berechnet die Stile für jedes Kind neu. Setze
transformdirekt auf das Element.
5. Easing und Dauer – oder eine Feder
Easing, in Entscheidungsreihenfolge:
| Situation | Easing |
|---|---|
| Eintritt oder Austritt | ease-out |
| Bewegung / Verformung auf dem Bildschirm | ease-in-out |
| Hover / Farbwechsel | ease |
| Gleichmäßige Bewegung (Laufschrift, Fortschritt) | linear |
| Standard | ease-out |
Niemals ease-in bei UI. Es beginnt langsam und verzögert den genauen Moment, den der Benutzer beobachtet. ease-out bei 200 ms fühlt sich schneller an als ease-in bei 200 ms.
Integrierte CSS-Easings sind zu schwach. Verwende diese:
--ease-out-soft: cubic-bezier(0.22, 1, 0.36, 1); /* Core-Token; starkes ease-out für UI */
--ease-in-out-soft: cubic-bezier(0.77, 0, 0.175, 1); /* starkes ease-in-out für On-Screen-Bewegung */
--ease-drawer: cubic-bezier(0.32, 0.72, 0, 1); /* iOS-ähnliche Drawer-Kurve (Ionic) */
Benötigst du eine Kurve, die hier nicht ist? Nimm sie von easing.dev oder easings.co. Baue keine selbst.
Dauer:
| Element | Dauer |
|---|---|
| Rückmeldung bei Tastendruck | var(--duration-press) (120 ms) |
| Tooltips, kleine Popovers | var(--duration-micro) (150 ms) |
| Dropdowns, Auswahlen | var(--duration-standard) (220 ms) |
| Modals | var(--duration-modal) (220 ms) |
| Drawer | var(--duration-drawer) (320 ms) |
| Marketing / erklärend | Kann länger sein |
UI-Animationen bleiben unter 300 ms. Ein 180-ms-Dropdown wirkt reaktionsschneller als ein 400-ms-Dropdown.
Greife stattdessen zu einer Feder, wenn die Bewegung ein 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-ähnlich – einfacher zu verstehen
{ type: "spring", mass: 1, stiffness: 100, damping: 10 } // traditionelle Physik – mehr Kontrolle
Halte den Bounce bei 0,1–0,3 und vermeide Bounce bei den meisten UI – reserviere ihn für Ziehen-zum-Schließen und verspielte Interaktionen.
6. Unterbrechung und Austritt
- Übergänge, nicht Keyframes, für alles, das schnell ausgelöst wird – Toasts, Kippschalter, alles, was ein Benutzer zweimal pro Sekunde auslösen kann. Übergänge zielen vom aktuellen Wert neu; Keyframes starten von Null.
- Federn für Gesten, weil sie Geschwindigkeit durch eine Unterbrechung tragen.
- Tritt so aus, wie es eingetreten ist. Ein Toast, der von unten hereingleitet, verlässt durch den Boden. Symmetrische Pfade sind es, die Wischen-zum-Schließen offensichtlich machen.
- Asymmetrisches Timing, wo der Benutzer entscheidet. Langsam in der bewussten Phase (ein Gedrückt-Halten-zum-Bestätigen-Drücken: 2 s linear), flott in der Systemantwort (Loslassen: 200 ms ease-out).
7. Reduzierte Bewegung und Zeiger-Gating
Wird mit der Animation ausgeliefert, jedes Mal.
@media (prefers-reduced-motion: reduce) {
.element {
animation: fade 0.2s ease;
} /* Opazität/Farbe behalten, Transform-basierte Bewegung entfernen */
}
@media (hover: hover) and (pointer: fine) {
.element:hover {
transform: scale(1.05);
} /* Touch löst falsche Hover bei Antippen aus */
}
const reduce = useReducedMotion();
const closedX = reduce ? 0 : "-100%";
Reduzierte Bewegung bedeutet weniger und sanftere Animationen, nicht null – behalte Übergänge bei, die das Verständnis unterstützen, entferne Bewegungen und Positionsänderungen.
Rezepte
Für fertig baubare Implementierungen der häufigen Fälle – Tastendruck, Dropdown, Tooltip, Modal, Drawer, Toast, Akkordeon, Staffelung, Gedrückt-Halten-zum-Bestätigen, Tab-Indikator, Scroll-Enthüllung, Ziehen-zum-Schließen – siehe RECIPES.md. Lade es, wann immer die Anfrage zu einer dieser Komponenten passt; beginne mit dem Rezept und nicht mit einer leeren Datei.
Niemals ausliefern
Selbstüberprüfung, bevor du fertig bist. Jedes davon 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 |
Integriertes ease-out bei einer bewussten Animation | cubic-bezier(0.23, 1, 0.32, 1) |
| Animation bei einem Tastaturkürzel oder einer 100+/Tag-Aktion | Keine Animation |
| UI-Dauer über 300 ms ohne Grund | 150–250 ms |
transform-origin: center bei einem auslöserverankerten Popover | var(--transform-origin) (Modals ausgenommen) |
| Keyframes bei Toasts, Kippschaltern, schnell ausgelösten Elementen | CSS-Übergänge |
Animieren von width/height/margin/padding/top/left | transform / opacity |
Motion x/y/scale-Eigenschaften 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 auf einmal ein | 30–80-ms-Staffelung |
Ausgabe
Schreibe den Code. Dann, in höchstens ein paar Zeilen:
- Das Hürdenergebnis – Häufigkeitsstufe und den benannten Zweck. Wenn etwas in der Anfrage abgelehnt wurde, sage was und warum.
- Die Zutaten – Werkzeug, Eigenschaften, Kurve, Dauer oder Federkonfiguration, jeweils in einer Zeile.
- Was auf Gefühl überprüft werden sollte – wenn das Ergebnis von Gefühl abhängt, das du nicht am Code beurteilen kannst (ein Überblenden, der Bounce einer Feder, das Opazitäts-/Höhen-Gleichgewicht in einer eintretenden Liste), sage dies und verweise auf den Check: spiele es mit 2–5-facher Dauer oder im DevTools-Animation-Inspektor ab, gehe es Frame für Frame durch, teste Gesten auf einem echten Gerät und sieh es dir später noch einmal an.