React Native Reanimated
Übersicht
Reanimated führt Animationen auf dem nativen UI-Thread aus – kein JS-Bridge-Engpass, keine ausgelassenen Frames. Animationen laufen mit 60fps, selbst wenn dein JavaScript-Thread ausgelastet ist. Es verwendet "Worklets" – kleine JavaScript-Funktionen, die über JSI auf dem UI-Thread ausgeführt werden. Der Standard für produktionsreife Animationen in React Native: gestengetriebene Interaktionen, Layout-Übergänge, scrollbasierte Effekte und Shared-Element-Übergänge.
Wann verwenden
- Jede Animation in React Native, die über einfache Opazität/Transform hinausgeht
- Gestengesteuerte Interaktionen (Wischen zum Löschen, Ziehen zum Neuanordnen, Pinch-to-Zoom)
- Scrollgesteuerte Animationen (Parallax-Header, klebrige Elemente)
- Layout-Animationen (Elemente, die in Listen erscheinen/verschwinden)
- Shared-Element-Übergänge zwischen Bildschirmen
Anleitung
Einrichtung
npx expo install react-native-reanimated react-native-gesture-handler
// babel.config.js – Reanimated-Plugin hinzufügen (MUSS das letzte sein)
module.exports = function (api) {
api.cache(true);
return {
presets: ["babel-preset-expo"],
plugins: ["react-native-reanimated/plugin"], // Muss das letzte sein!
};
};
Shared Values und animierte Styles
// components/FadeIn.tsx – Einfache Animation mit Shared Values
import Animated, {
useSharedValue,
useAnimatedStyle,
withTiming,
withSpring,
} from "react-native-reanimated";
import { useEffect } from "react";
export function FadeInCard({ children }) {
const opacity = useSharedValue(0);
const translateY = useSharedValue(20);
useEffect(() => {
opacity.value = withTiming(1, { duration: 600 });
translateY.value = withSpring(0, { damping: 15 });
}, []);
const animatedStyle = useAnimatedStyle(() => ({
opacity: opacity.value,
transform: [{ translateY: translateY.value }],
}));
return (
<Animated.View style={animatedStyle} className="bg-white rounded-xl p-4 shadow-lg">
{children}
</Animated.View>
);
}
Gesten-Animationen
// components/SwipeToDelete.tsx – Wischgeste mit Animation
import Animated, {
useSharedValue,
useAnimatedStyle,
withSpring,
runOnJS,
} from "react-native-reanimated";
import { Gesture, GestureDetector } from "react-native-gesture-handler";
export function SwipeToDelete({ onDelete, children }) {
const translateX = useSharedValue(0);
const pan = Gesture.Pan()
.onUpdate((event) => {
// Nur nach links wischen zulassen
translateX.value = Math.min(0, event.translationX);
})
.onEnd((event) => {
if (event.translationX < -150) {
// Weit genug gewischt – löschen
translateX.value = withSpring(-400);
runOnJS(onDelete)();
} else {
// Zurückschnappen
translateX.value = withSpring(0);
}
});
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateX: translateX.value }],
}));
return (
<GestureDetector gesture={pan}>
<Animated.View style={animatedStyle}>
{children}
</Animated.View>
</GestureDetector>
);
}
Layout-Animationen
// components/AnimatedList.tsx – Elemente animieren automatisch ein/aus
import Animated, { FadeInDown, FadeOutLeft, LinearTransition } from "react-native-reanimated";
export function AnimatedList({ items, onRemove }) {
return (
<Animated.FlatList
data={items}
itemLayoutAnimation={LinearTransition}
renderItem={({ item, index }) => (
<Animated.View
entering={FadeInDown.delay(index * 100).springify()}
exiting={FadeOutLeft.duration(300)}
className="bg-white p-4 mx-4 my-1 rounded-lg"
>
<Text>{item.title}</Text>
<Pressable onPress={() => onRemove(item.id)}>
<Text className="text-red-500">Entfernen</Text>
</Pressable>
</Animated.View>
)}
/>
);
}
Scrollgesteuerte Animationen
// components/ParallaxHeader.tsx – Parallax-Effekt beim Scrollen
import Animated, {
useAnimatedScrollHandler,
useSharedValue,
useAnimatedStyle,
interpolate,
} from "react-native-reanimated";
export function ParallaxHeader() {
const scrollY = useSharedValue(0);
const scrollHandler = useAnimatedScrollHandler({
onScroll: (event) => {
scrollY.value = event.contentOffset.y;
},
});
const headerStyle = useAnimatedStyle(() => ({
height: interpolate(scrollY.value, [-100, 0, 200], [400, 300, 100]),
opacity: interpolate(scrollY.value, [0, 200], [1, 0.3]),
transform: [
{ translateY: interpolate(scrollY.value, [0, 200], [0, -50]) },
],
}));
return (
<>
<Animated.View style={headerStyle} className="bg-blue-600">
<Text className="text-white text-3xl font-bold">Meine App</Text>
</Animated.View>
<Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>
{/* Inhalt */}
</Animated.ScrollView>
</>
);
}
Beispiele
Beispiel 1: Karten-Swipe-Oberfläche erstellen
Benutzeraufforderung: "Erstelle eine Tinder-ähnliche Karten-Swipe-Oberfläche mit flüssigen Animationen."
Der Agent erstellt einen Kartenstapel mit Pan-Gesten, Rotation basierend auf der Wischrichtung, Spring-Animationen für das Zurückschnappen und Layout-Übergänge für das Entfernen von Karten.
Beispiel 2: Animiertes Bottom-Sheet
Benutzeraufforderung: "Erstelle ein Bottom-Sheet, das nach oben gezogen werden kann und an Positionen einrastet."
Der Agent verwendet Pan-Gesten mit Einrastpunkten, Shared Values für die Höhe und Spring-Animationen für sanftes Einrasten.
Richtlinien
- Shared Values für Animationszustand –
useSharedValueläuft auf dem UI-Thread useAnimatedStylefür dynamische Styles – wird auf dem UI-Thread neu berechnetwithSpringfür natürliche Bewegung –withTimingfür präzise DauerrunOnJSum JS von Worklets aus aufzurufen – Brücke zurück zum JS-Thread, wenn nötig- Gesture Handler Integration –
Gesture.Pan(),Gesture.Pinch(), usw. - Layout-Animationen sind deklarativ –
entering,exitingProps auf animierten Komponenten interpolatefür Wertezuordnung – Scrollposition auf Opazität, Skalierung usw. abbilden- Babel-Plugin muss das letzte sein –
react-native-reanimated/pluginam Ende des Plugins-Arrays - Greife in Worklets nicht auf JS-Objekte zu – nur Shared Values und Primitive
scrollEventThrottle={16}– Scroll-Ereignisse mit 60fps für flüssige Animationen