React Native Reanimated
Resumen
Reanimated ejecuta animaciones en el hilo nativo de la UI, sin el cuello de botella del puente JS, sin fotogramas perdidos. Las animaciones se mantienen a 60 fps incluso cuando el hilo de JavaScript está ocupado. Utiliza "worklets" — pequeñas funciones JavaScript que se ejecutan en el hilo de la UI a través de JSI. Es el estándar para animaciones de calidad de producción en React Native: interacciones basadas en gestos, transiciones de diseño, efectos basados en desplazamiento y transiciones de elementos compartidos.
Cuándo Usarlo
- Cualquier animación en React Native más allá de simple opacidad/transformación
- Interacciones basadas en gestos (deslizar para eliminar, arrastrar para reordenar, pellizcar para zoom)
- Animaciones controladas por desplazamiento (encabezados parallax, elementos pegajosos)
- Animaciones de diseño (elementos que entran/salen de listas)
- Transiciones de elementos compartidos entre pantallas
Instrucciones
Configuración
npx expo install react-native-reanimated react-native-gesture-handler
// babel.config.js — Agrega el plugin de Reanimated (DEBE ser el último)
module.exports = function (api) {
api.cache(true);
return {
presets: ["babel-preset-expo"],
plugins: ["react-native-reanimated/plugin"], // ¡Debe ser el último!
};
};
Valores Compartidos y Estilos Animados
// components/FadeIn.tsx — Animación básica con valores compartidos
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>
);
}
Animaciones con Gestos
// components/SwipeToDelete.tsx — Gesto de deslizar con animación
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) => {
// Solo permitir deslizar hacia la izquierda
translateX.value = Math.min(0, event.translationX);
})
.onEnd((event) => {
if (event.translationX < -150) {
// Deslizó lo suficiente — eliminar
translateX.value = withSpring(-400);
runOnJS(onDelete)();
} else {
// Volver a la posición original
translateX.value = withSpring(0);
}
});
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateX: translateX.value }],
}));
return (
<GestureDetector gesture={pan}>
<Animated.View style={animatedStyle}>
{children}
</Animated.View>
</GestureDetector>
);
}
Animaciones de Diseño
// components/AnimatedList.tsx — Los elementos se animan al entrar/salir automáticamente
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">Eliminar</Text>
</Pressable>
</Animated.View>
)}
/>
);
}
Animaciones Basadas en Desplazamiento
// components/ParallaxHeader.tsx — Efecto parallax al hacer scroll
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">Mi App</Text>
</Animated.View>
<Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>
{/* Contenido */}
</Animated.ScrollView>
</>
);
}
Ejemplos
Ejemplo 1: Construye una interfaz de deslizamiento de tarjetas
Solicitud del usuario: "Construye una interfaz de deslizamiento de tarjetas estilo Tinder con animaciones suaves."
El agente creará un mazo de tarjetas con gestos de arrastre, rotación basada en la dirección del deslizamiento, animaciones con resorte para volver a la posición inicial y transiciones de diseño para la eliminación de tarjetas.
Ejemplo 2: Hoja inferior animada
Solicitud del usuario: "Crea una hoja inferior que se pueda arrastrar hacia arriba y que se fije en posiciones."
El agente usará gestos de arrastre con puntos de anclaje, valores compartidos para la altura y animaciones con resorte para un ajuste suave.
Pautas
- Valores compartidos para el estado de animación —
useSharedValuese ejecuta en el hilo de la UI useAnimatedStylepara estilos dinámicos — se recalcula en el hilo de la UIwithSpringpara movimiento natural —withTimingpara duración precisarunOnJSpara llamar a JS desde worklets — puente de regreso al hilo JS cuando sea necesario- Integración con Gesture Handler —
Gesture.Pan(),Gesture.Pinch(), etc. - Las animaciones de diseño son declarativas — props
entering,exitingen componentes Animated interpolatepara mapeo de valores — mapear posición de desplazamiento a opacidad, escala, etc.- El plugin de Babel debe ser el último —
react-native-reanimated/pluginal final del array de plugins - No acceder a objetos JS en worklets — solo valores compartidos y primitivos
scrollEventThrottle={16}— eventos de desplazamiento a 60 fps para animaciones suaves