O que React Native Reanimated faz?
Visão Geral
Reanimated executa animações na thread nativa de UI — sem gargalo na ponte JS, sem quadros perdidos. As animações permanecem a 60fps mesmo quando a thread JavaScript está ocupada. Ele usa "worklets" — pequenas funções JavaScript que executam na thread de UI via JSI. O padrão para animações de qualidade profissional no React Native: interações guiadas por gestos, transições de layout, efeitos baseados em rolagem e transições de elementos compartilhados.
Quando Usar
- Qualquer animação no React Native além de opacidade/transformação simples
- Interações guiadas por gestos (deslizar para excluir, arrastar para reordenar, pinçar para ampliar)
- Animações orientadas por rolagem (cabeçalhos parallax, elementos fixos)
- Animações de layout (itens entrando/saindo de listas)
- Transições de elementos compartilhados entre telas
Instruções
Configuração
npx expo install react-native-reanimated react-native-gesture-handler
// babel.config.js — Adicione o plugin do Reanimated (DEVE ser o último)
module.exports = function (api) {
api.cache(true);
return {
presets: ["babel-preset-expo"],
plugins: ["react-native-reanimated/plugin"], // Deve ser o último!
};
};
Valores Compartilhados e Estilos Animados
// components/FadeIn.tsx — Animação básica com valores compartilhados
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>
);
}
Animações com Gestos
// components/SwipeToDelete.tsx — Gesto de deslizar com animação
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) => {
// Apenas permite deslizar para a esquerda
translateX.value = Math.min(0, event.translationX);
})
.onEnd((event) => {
if (event.translationX < -150) {
// Deslizou o suficiente — excluir
translateX.value = withSpring(-400);
runOnJS(onDelete)();
} else {
// Voltar ao lugar
translateX.value = withSpring(0);
}
});
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateX: translateX.value }],
}));
return (
<GestureDetector gesture={pan}>
<Animated.View style={animatedStyle}>
{children}
</Animated.View>
</GestureDetector>
);
}
Animações de Layout
// components/AnimatedList.tsx — Itens animam entrada/saída automaticamente
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">Remover</Text>
</Pressable>
</Animated.View>
)}
/>
);
}
Animações Orientadas por Rolagem
// components/ParallaxHeader.tsx — Efeito parallax na rolagem
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">Meu App</Text>
</Animated.View>
<Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>
{/* Conteúdo */}
</Animated.ScrollView>
</>
);
}
Exemplos
Exemplo 1: Construir uma interface de deslizar cartões
Prompt do usuário: "Construa uma interface de deslizar cartões estilo Tinder com animações suaves."
O agente criará uma pilha de cartões com gestos de pan, rotação baseada na direção do deslize, animações spring para voltar ao lugar e transições de layout para remoção de cartões.
Exemplo 2: Bottom sheet animado
Prompt do usuário: "Crie um bottom sheet que possa ser arrastado para cima e encaixe em posições."
O agente usará gestos pan com pontos de encaixe, valores compartilhados para altura e animações spring para encaixe suave.
Diretrizes
- Valores compartilhados para estado de animação —
useSharedValueexecuta na thread de UI useAnimatedStylepara estilos dinâmicos — recalculado na thread de UIwithSpringpara movimento natural —withTimingpara duração precisarunOnJSpara chamar JS a partir de worklets — ponte de volta para a thread JS quando necessário- Integração com Gesture Handler —
Gesture.Pan(),Gesture.Pinch(), etc. - Animações de layout são declarativas — props
entering,exitingem componentes Animated interpolatepara mapeamento de valores — mapear posição de rolagem para opacidade, escala, etc.- Plugin Babel deve ser o último —
react-native-reanimated/pluginno final do array de plugins - Não acessar objetos JS em worklets — apenas valores compartilhados e primitivos
scrollEventThrottle={16}— eventos de rolagem a 60fps para animações suaves