React Native Reanimated
Aperçu
Reanimated exécute des animations sur le thread UI natif — pas de goulot d'étranglement du pont JS, pas de chutes d'images. Les animations restent à 60 ips même lorsque votre thread JavaScript est occupé. Il utilise des « worklets » — de petites fonctions JavaScript qui s'exécutent sur le thread UI via JSI. La référence pour des animations de qualité production dans React Native : interactions basées sur les gestes, transitions de mise en page, effets liés au défilement, et transitions d'éléments partagés.
Quand l'utiliser
- Toute animation dans React Native au-delà d'une simple opacité/transformation
- Interactions basées sur les gestes (balayer pour supprimer, glisser-déposer pour réorganiser, pincer pour zoomer)
- Animations liées au défilement (en-têtes en parallaxe, éléments fixes)
- Animations de mise en page (éléments entrant/sortant d'une liste)
- Transitions d'éléments partagés entre les écrans
Instructions
Configuration
npx expo install react-native-reanimated react-native-gesture-handler
// babel.config.js — Ajouter le plugin Reanimated (DOIT être le dernier)
module.exports = function (api) {
api.cache(true);
return {
presets: ["babel-preset-expo"],
plugins: ["react-native-reanimated/plugin"], // Doit être le dernier !
};
};
Valeurs partagées et styles animés
// components/FadeIn.tsx — Animation de base avec des valeurs partagées
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>
);
}
Animations gestuelles
// components/SwipeToDelete.tsx — Balayage gestuel avec 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) => {
// Autoriser uniquement le balayage vers la gauche
translateX.value = Math.min(0, event.translationX);
})
.onEnd((event) => {
if (event.translationX < -150) {
// Balayage suffisamment loin — supprimer
translateX.value = withSpring(-400);
runOnJS(onDelete)();
} else {
// Revenir en arrière
translateX.value = withSpring(0);
}
});
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateX: translateX.value }],
}));
return (
<GestureDetector gesture={pan}>
<Animated.View style={animatedStyle}>
{children}
</Animated.View>
</GestureDetector>
);
}
Animations de mise en page
// components/AnimatedList.tsx — Les éléments s'animent automatiquement à l'entrée/sortie
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">Supprimer</Text>
</Pressable>
</Animated.View>
)}
/>
);
}
Animations liées au défilement
// components/ParallaxHeader.tsx — Effet de parallaxe lors du défilement
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">Mon Appli</Text>
</Animated.View>
<Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>
{/* Contenu */}
</Animated.ScrollView>
</>
);
}
Exemples
Exemple 1 : Construire une interface de balayage de cartes
Requête utilisateur : « Construis une interface de balayage de cartes façon Tinder avec des animations fluides. »
L'agent créera une pile de cartes avec des gestes de déplacement, une rotation basée sur la direction du balayage, des animations à ressort pour le rebond, et des transitions de mise en page pour la suppression des cartes.
Exemple 2 : Feuille inférieure animée
Requête utilisateur : « Crée une feuille inférieure qui peut être glissée vers le haut et s'arrêter à des positions. »
L'agent utilisera des gestes de déplacement avec des points d'arrêt, des valeurs partagées pour la hauteur, et des animations à ressort pour un accrochage fluide.
Consignes
- Valeurs partagées pour l'état d'animation —
useSharedValues'exécute sur le thread UI useAnimatedStylepour les styles dynamiques — recalculé sur le thread UIwithSpringpour un mouvement naturel —withTimingpour une durée préciserunOnJSpour appeler JS depuis les worklets — pont de retour vers le thread JS si nécessaire- Intégration Gesture Handler —
Gesture.Pan(),Gesture.Pinch(), etc. - Les animations de mise en page sont déclaratives — propriétés
entering,exitingsur les composants Animated interpolatepour le mappage de valeurs — mapper la position de défilement à l'opacité, l'échelle, etc.- Le plugin Babel doit être le dernier —
react-native-reanimated/pluginà la fin du tableau plugins - Ne pas accéder aux objets JS dans les worklets — uniquement des valeurs partagées et des primitives
scrollEventThrottle={16}— événements de défilement à 60 ips pour des animations fluides