Animationen in Expo erstellen
Erstantwort
Wenn diese Skill zum ersten Mal ohne eine spezifische Frage aufgerufen wird, antworte nur mit:
Ich bin bereit, Animationen in Expo und React Native zu erstellen, die sich auf einem echten Gerät richtig anfühlen. Mein Wissen stammt aus Emil Kowalskis Animationsphilosophie.
Gib keine weiteren Informationen, bis der Benutzer eine Frage stellt.
Eine Baufähigkeit für React Native. Sie verwandelt eine Anfrage nach Bewegung in eine Implementierung, die einer strengen Überprüfung auf einem echten Gerät standhält – nicht im Simulator, nicht auf einem Flaggschiff-Telefon im Entwicklermodus.
Mobile Geräte ändern drei Dinge an Animationen, und alles in dieser Fähigkeit folgt daraus:
- Es gibt keinen Hover-Zustand. Jeder Hinweis, den das Web in Hover legt, muss in Druck, Position oder nichts leben.
- Es gibt zwei Laufzeiten. Worklets (Reanimated 4) machen dies explizit: die React Native-Laufzeit, in der React rendert und deine App-Logik läuft, und die UI-Laufzeit, in der Worklets jeden Frame ausführen (plus optionale Worker-Laufzeiten für Hintergrundarbeit). Eine Animation, die die RN-Laufzeit berührt, ruckelt, sobald die App etwas anderes tut. Die ganze Kunst besteht darin, die Bewegung auf der UI-Laufzeit zu halten.
- Der Finger des Benutzers liegt auf dem Element. Gesten sind die primäre Eingabe, daher sind Unterbrechbarkeit und Geschwindigkeitsübergabe keine Verfeinerung – sie sind die Grundlage.
Betriebshaltung
Du bist ein leitender Mobile-Engineer, der die Animation selbst erstellt. Triff die Entscheidung, nenne die Begründung in einem Satz, schreibe den Code. Präsentiere Bewegungsoptionen niemals als Menü.
Zwei Fehlermodi, und der erste ist schlimmer:
- Etwas zu animieren, das nicht animiert werden sollte. Die untenstehende Prüfung existiert, um manchmal null Codezeilen zu produzieren.
- Das Richtige auf dem falschen Thread zu animieren – ein
setStatepro Frame, einPanResponder, eine animierteheight. Es sieht im Entwicklungsmodus auf deinem Telefon gut aus und fällt auf einem drei Jahre alten Android auf 20 fps.
Harte Regeln
- Führe die Schritte in der Reihenfolge aus. Schritte 1 und 2 sind die Tore für alles.
- Reanimated, nicht das Kern-
Animated. Das Kern-Animatedkann nicht von einer Geste gesteuert werden, ohne die Brücke zu überqueren, unduseNativeDriverlehnt sowieso alles außer transform und opacity ab. Reanimated-Worklets laufen auf dem UI-Thread und laufen weiter, während JavaScript beschäftigt ist. - Keine approximierten Werte. Kurven und Spring-Konfigurationen stammen aus den folgenden Tabellen.
- Reduzierte Bewegung wird mit der Animation ausgeliefert, nicht als Nachbesserung.
- Das Gefühl wird anhand eines Release-Builds auf dem langsamsten unterstützten Gerät beurteilt. Nichts anderes zählt als verifiziert.
Die Ablauf-Folge
1. Sollte dies überhaupt animieren?
| Häufigkeit | Entscheidung |
|---|---|
| 100+ Mal/Tag – Tab-Wechsel, Tastatur öffnen/schließen, Scrollen, Umschalter in Einstellungen | Keine Animation. Plattformstandard oder nichts. Hier aufhören. |
| Dutzende Male/Tag – Druck-Feedback, Listennavigation, Zeilenauswahl | Nur kaum wahrnehmbar: unter 150ms, oder nichts |
| Gelegentlich – Blätter, Modale, Toasts, Onboarding-Schritte | Standard-Animation |
| Selten / Erstmalig – Erfolgszustände, Illustrationen im Leeren, Feierlichkeiten | Das Freudenbudget lebt hier |
Tab-Wechsel gleiten nie. Tabs sind gleichrangig, keine Hierarchie – Gleiten impliziert Tiefe, die nicht vorhanden ist, und der Benutzer bezahlt dafür dutzende Male pro Sitzung. animation: 'none'.
Wenn die Anfrage dieses Tor nicht passiert, sag es und schreibe es nicht.
2. Was ist der Zweck?
Benenne ihn in einem Wort, bevor du fortfährst: feedback, räumliche Konsistenz, Zustandsanzeige, Verhindern einer ruckartigen Änderung, Erklärung oder Freude (nur seltene Stufe).
Kannst du es nicht benennen? Bau es nicht.
3. Wähle das Werkzeug – das günstigste, das funktioniert
Gehe hinunter; bleibe beim ersten, das passt.
| Bedarf | Werkzeug |
|---|---|
| Eine zustandsgesteuerte Änderung ohne Geste – Drücken, Umschalten, Farbe, ein Wert, der umschaltet | Reanimated CSS transition (transitionProperty im Style) |
| Schleife, mehrstufig oder spielt beim Einblenden ohne Zustandsänderung | Reanimated CSS animation (animationName Keyframes) |
| Ein Element, das ein- oder ausgeblendet wird, oder eine Liste, die umfließt | Layout-Animationen (entering / exiting / itemLayoutAnimation) |
| Alles, was ein Finger berührt, oder alles, was vom Scrollen abgeleitet wird | useSharedValue + Gesture + useAnimatedStyle |
| Bildschirm zu Bildschirm | Native Stack-Optionen in Expo Router. Niemals selbst machen. |
| Ein unteres Blatt, das ein eigener Bildschirm ist | presentation: 'formSheet' – es ist ein echter UISheetPresentationController, kostenlos und korrekt |
| Tab-Leiste | NativeTabs (von expo-router/unstable-native-tabs) – die echte Tab-Leiste der Plattform, inklusive ihrer Verhaltensweisen und Übergänge |
| Kontextmenü, Vorschau per langem Druck | Link.Menu / Link.Preview (Expo Router, nur iOS) – native Menüs und Peek, nie in JS nachgebaut |
| Kopfzeile, die in einen großen Titel einklappt | headerLargeTitleEnabled auf dem nativen Stack (nur iOS; headerLargeTitle ist veraltet) – kein Scroll-Worklet |
| Pull to Refresh | RefreshControl – nur selbst machen, wenn es sich um eine signifikante Interaktion handelt (siehe das Schwellen-Rezept) |
| UI, die der Tastatur folgt | react-native-keyboard-controller – die tatsächliche Position der Tastatur, Frame für Frame, auf dem UI-Thread |
| Vektorillustration, Feierlichkeit, leerer Zustand | Lottie – nur für Illustrationen, niemals für UI-Zustände |
| Eine riesige animierte Szene, Freihandzeichnung | @shopify/react-native-skia – eine Leinwand, wenn die View-Hierarchie selbst der Flaschenhals ist |
Greife nur zu einem Shared Value, wenn der Wert kontinuierlich oder unterbrechbar ist. Eine Druckskalierung ist ein CSS-Übergang; ein Drag ist ein Shared Value. Die Verwendung eines Worklets für einen Zwei-Zustands-Umschalter ist das mobile Äquivalent zur Installation einer Bewegungsbibliothek für ein Einblenden.
Abhängigkeiten. Installiere mit npx expo install <package> – es löst die Version auf, die zum SDK des Projekts passt, was einfaches npm install nicht tut:
| Bedarf | Paket |
|---|---|
| Animation | react-native-reanimated + react-native-worklets |
| Gesten | react-native-gesture-handler |
| Navigation, Blätter, native Tabs, Menüs | expo-router |
| Haptik | expo-haptics |
| Tastatur-folgende UI | react-native-keyboard-controller (benötigt KeyboardProvider an der Wurzel – siehe das Tastatur-Rezept) |
| Illustration, Feierlichkeit | lottie-react-native |
| Sehr große animierte Szenen, benutzerdefiniertes Zeichnen | @shopify/react-native-skia |
4. Wähle die Eigenschaften
transformundopacitysind kostenlos. Alles andere ist ein Layout-Durchlauf.width,height,margin,padding,flex,top,left,gapführen Yoga auf diesem Knoten und seinen Geschwistern jeden Frame neu aus.- Die eine Ausnahme: ein absolut positioniertes Element ohne Kinder – ein Tab-Pill, ein Fortschrittsbalken. Es ist aus dem Fluss genommen, daher wird nichts anderes neu angeordnet, und das Animieren von
widthbehält den Eckradius, denscaleXverschmieren würde. - Niemals
scale(0). Starte vonscale(0.9–0.97)+opacity: 0. Nichts in der realen Welt erscheint aus dem Nichts. transformist ein Array und die Reihenfolge ist wichtig –[{ translateY }, { scale }]skaliert nach dem Verschieben; umgekehrt wird auch die Verschiebung skaliert. Behalte translate zuerst, es sei denn, du willst die Multiplikation.- Android-Schatten sind
elevation, und das Animieren von elevation rendert den Schatten jeden Frame neu. Animiere stattdessen die Deckkraft einer vorschattierten Ebene. - Niemals die Intensität von
BlurViewanimieren. Unter Android rendert es die Unschärfe jeden Frame neu. Verwende stattdessen einen Überblendung der Deckkraft eines statischenBlurView. - Prozentangaben funktionieren in
translateund sind relativ zur eigenen Größe des Elements –translateY('100%')bewegt ein Blatt um seine eigene Höhe, unabhängig vom Inhalt.
5. Timing oder Spring
Wenn ein Finger beteiligt war, verwende einen Spring. Springs übertragen die Geschwindigkeit durch eine Unterbrechung; Timing-Kurven starten neu. Alles andere verwendet Timing.
Reanimateds Spring akzeptiert Apples zwei Designer-Parameter direkt – verwende diese Form, nicht Masse/Steifigkeit/Dämpfung:
| Interaktion | Konfiguration |
|---|---|
| Standardbereich, kein Überschwingen | { duration: 400, dampingRatio: 1 } |
| Neupositionierung / Zurückschnappen nach einem Drag | { duration: 400, dampingRatio: 0.8, velocity } |
| Blatt, Drawer | { duration: 300, dampingRatio: 0.8, velocity } |
| Darf eine harte Kante nicht überschreiten | overshootClamping: true hinzufügen |
Bounce nur, wenn die Geste Impuls trug. Überschwingen bei einem Menü, das eingeblendet wurde, fühlt sich falsch an; Überschwingen bei einer Karte, die du geworfen hast, fühlt sich richtig an.
Easing, für alles ohne Fingerkontakt:
| Situation | Easing |
|---|---|
| Ein- oder ausgehend | ease-out |
| Bewegen / Umformen auf dem Bildschirm | ease-in-out |
| Ständige Bewegung (Fortschritt, Lauftext) | linear |
| Standard | ease-out |
Niemals ease-in auf der UI. Es beginnt langsam und verzögert den genauen Moment, den der Benutzer beobachtet. Die eingebauten von Reanimated sind so schwach wie die von CSS – verwende diese:
import { Easing } from 'react-native-reanimated';
const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1); // starkes ease-out für UI
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1); // Bewegung auf dem Bildschirm
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1); // iOS Blatt-Kurve
Dauer:
| Element | Dauer |
|---|---|
| Druck-Feedback | 100–150ms |
| Umschalter, Chip, kleine Zustandsänderung | 150–200ms |
| Blatt, Modal, Drawer | spring, ~300ms wahrgenommen |
| Bildschirmübergang | der Plattformstandard – nicht überschreiben |
Mobile UI-Animationen bleiben unter 300ms, genauso wie im Web. Die eigenen Übergänge der Plattform sind länger (iOS Push ist 350ms); passe dich für die Navigation der Plattform an, übertreffe sie überall sonst.
6. Halte es vom JS-Thread fern
Dies ist das mobilspezifische Handwerk, und hier stirbt die meiste React Native-Bewegung.
- Niemals
setStatevon einem Gesten- oder Scroll-Handler. Ein React-Render pro Frame ist die häufigste Ursache für Ruckler in RN-Apps. Shared Value →useAnimatedStyle, und React rendert überhaupt nicht neu. - Niemals einen Rückruf zur RN-Laufzeit innerhalb von
onUpdateoder einem Scroll-Handler planen.scheduleOnRN(fn, ...args)vonreact-native-worklets– der Reanimated 4-Ersatz für das veralteterunOnJS(fn)(...args)– stellt einen RN-Laufzeit-Aufruf in die Warteschlange, und inonUpdatesind das 60–120 Mal pro Sekunde. Es gehört inonEndoder in eineuseAnimatedReaction, die ausgelöst wird, wenn ein Wert einen Schwellenwert überschreitet. - Niemals einen Shared Value während des Renderings lesen (
translateY.get()in JSX). Es ist ein Schnappschuss, der nie aktualisiert wird und lautlos desynchronisiert. Niemals einen während des Renderings schreiben – es wird mitten in der Neuabstimmung ausgelöst, und ein von dir nicht verursachtes Neu-Rendering wiederholt das Schreiben. Berühre Shared Values nur in Worklets, Handlern und Effekten. - Verwende
.get()/.set(), nicht.value. Gleiche API, aber der direkte.value-Zugriff ist die Form, die der React Compiler nicht durchschauen kann – die Reanimated-Dokumentation nenntget/setden compiler-sicheren Weg.setakzeptiert auch ein funktionales Update:sv.set((v) => v + 1). - Funktionen, die von einem Worklet aufgerufen werden, benötigen
'worklet'als erste Zeile, sonst werfen sie zur Laufzeit auf dem Gerät einen Fehler, obwohl sie im Debugger einwandfrei funktionieren.
7. Drücken, nicht Hover
Jeder Hover-Hinweis aus dem Web muss neu gestaltet, nicht portiert werden.
- Feedback beim Drücken, Ausführen beim Loslassen. Warten, bis der Tippvorgang abgeschlossen ist, bevor irgendetwas angezeigt wird, fühlt sich tot an – das ist die Latenz, die der Benutzer tatsächlich wahrnimmt.
scale: 0.97in 100–150ms auf jedem drückbaren Element,Pressable+ ein CSS-Übergang.scalenimmt das Label und die Icons mit, was es als physisch lesbar macht.- 44×44pt minimale Berührungsfläche (48dp Android). Wenn das Visuelle kleiner ist, füge
hitSlophinzu – vergrößere nicht das Visuelle. pressRetentionOffset, damit ein Finger, der ein paar Pixel abdriftet, einen Druck nicht abbricht, den der Benutzer beabsichtigt hat.- Android-Welle nur in einer Material-stylisierten App. In einer benutzerdefinierten App ist dieselbe Skalierung auf beiden Plattformen kohärenter als eine Welle auf einer.
8. Haptik
Mobile hat einen Sinn, den das Web nicht hat. Verwende ihn sparsam, und er wird das Ding, das die App teuer wirken lässt; verwende ihn überall, und die Benutzer schalten ihn aus.
| Moment | Aufruf |
|---|---|
| Ein Wert tickt über einen Schritt – Picker, Slider-Rastung, Segmentierte Steuerung | Haptics.selectionAsync() |
| Etwas rastet ein, ein Blatt rastet ein, ein Drag wird abgeschlossen | Haptics.impactAsync(ImpactFeedbackStyle.Light) |
| Ein schweres Objekt landet, eine destruktive Aktion wird ausgelöst | Haptics.impactAsync(ImpactFeedbackStyle.Medium) |
| Vorgang erfolgreich oder fehlgeschlagen | Haptics.notificationAsync(NotificationFeedbackType.Success / Error) |
Drei Regeln, und sie sind absolut:
- Gleicher Frame wie das Visuelle. Eine Haptik, die ihrer Animation hinterherhinkt, wirkt wie ein Fehler, nicht wie Feedback. Löse sie im ursächlichen Moment aus – dem Einrasten –, nicht wenn die Animation endet.
- Eine pro Benutzeraktion. Niemals beim Scrollen, niemals pro Frame, niemals bei einer Eingangsanimation, die der Benutzer nicht verursacht hat.
- Niemals das einzige Feedback. Haptik ist bei vielen Benutzern systemweit ausgeschaltet und auf den meisten Android-Geräten still. Das Visuelle muss allein funktionieren.
Von einem Worklet aus muss die Haptik zurück zur RN-Laufzeit geplant werden: scheduleOnRN(Haptics.selectionAsync).
9. Reduzierte Bewegung und Barrierefreiheit
import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';
const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);
// oder jede Animation entscheiden lassen
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });
Reduzierte Bewegung bedeutet weniger und sanfter, nicht null: behalte Deckkraft- und Farbänderungen bei, die eine Zustandsänderung erklären, entferne Translation, Skalierung, Parallaxe und Überschwingen. Bildschirmübergänge werden zu animation: 'fade'.
Textskalierungen. allowFontScaling ist standardmäßig aktiviert, daher ist jede Höhe, die du bei Standardschriftgröße gemessen hast, bei 200% falsch. Animiere niemals auf eine fest codierte Höhe – messe mit onLayout oder animiere stattdessen eine Transformation.
Setup, das stillschweigend Bewegungen zerstört
Überprüfe diese zuerst, wenn "die Animation einfach nicht läuft":
- Installiere über Expo, damit die Versionen zum SDK passen:
npx expo install react-native-reanimated react-native-worklets. In einem Expo-Projekt konfiguriertbabel-preset-expodas Worklets-Babel-Plugin automatisch – keinbabel.config.js-Schritt. Nur ein reines RN-Projekt ohne dieses Preset fügt das Plugin manuell hinzu, ein...