React Native Reanimated 是做什么的?
概述
Reanimated 在原生 UI 线程上运行动画——无 JS 桥接瓶颈,无掉帧。即使在 JavaScript 线程繁忙时,动画也能保持 60fps。它使用“worklet”——通过 JSI 在 UI 线程上执行的小型 JavaScript 函数。生产级 React Native 动画的标准:手势驱动交互、布局过渡、滚动效果和共享元素过渡。
何时使用
- 任何超越简单透明度/变换的 React Native 动画
- 手势驱动交互(滑动删除、拖拽排序、捏合缩放)
- 滚动驱动动画(视差头部、粘性元素)
- 布局动画(列表项进入/离开)
- 屏幕间的共享元素过渡
说明
设置
npx expo install react-native-reanimated react-native-gesture-handler
// babel.config.js — 添加 Reanimated 插件(必须在最后)
module.exports = function (api) {
api.cache(true);
return {
presets: ["babel-preset-expo"],
plugins: ["react-native-reanimated/plugin"], // 必须在最后!
};
};
共享值与动画样式
// components/FadeIn.tsx — 使用共享值实现基础动画
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>
);
}
手势动画
// components/SwipeToDelete.tsx — 滑动删除手势
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) => {
// 仅允许向左滑动
translateX.value = Math.min(0, event.translationX);
})
.onEnd((event) => {
if (event.translationX < -150) {
// 滑动距离足够——删除
translateX.value = withSpring(-400);
runOnJS(onDelete)();
} else {
// 回弹
translateX.value = withSpring(0);
}
});
const animatedStyle = useAnimatedStyle(() => ({
transform: [{ translateX: translateX.value }],
}));
return (
<GestureDetector gesture={pan}>
<Animated.View style={animatedStyle}>
{children}
</Animated.View>
</GestureDetector>
);
}
布局动画
// components/AnimatedList.tsx — 列表项自动进行进入/退出动画
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">删除</Text>
</Pressable>
</Animated.View>
)}
/>
);
}
滚动驱动动画
// components/ParallaxHeader.tsx — 滚动视差效果
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">我的应用</Text>
</Animated.View>
<Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>
{/* 内容 */}
</Animated.ScrollView>
</>
);
}
示例
示例 1:构建卡片滑动界面
用户提示: “构建一个类似 Tinder 的卡片滑动界面,具有流畅动画。”
智能体将创建一个卡片栈,包含平移手势、基于滑动方向的旋转、用于回弹的弹簧动画,以及卡片移除时的布局过渡。
示例 2:带动画的底部抽屉
用户提示: “创建一个可以向上拖动并吸附到特定位置的底部抽屉。”
智能体将使用带吸附点的平移手势、用于高度的共享值,以及用于平滑吸附的弹簧动画。
指南
- 使用共享值管理动画状态 —
useSharedValue在 UI 线程上运行 - 使用
useAnimatedStyle处理动态样式 — 在 UI 线程上重新计算 - 使用
withSpring实现自然运动 —withTiming用于精确时长 - 使用
runOnJS从 worklet 调用 JS — 在需要时桥接回 JS 线程 - 手势处理器集成 —
Gesture.Pan(),Gesture.Pinch()等 - 布局动画是声明式的 — 在 Animated 组件上使用
entering、exiting属性 - 使用
interpolate进行值映射 — 将滚动位置映射到透明度、缩放等 - Babel 插件必须在最后 —
react-native-reanimated/plugin位于 plugins 数组末尾 - 不要在 worklet 中访问 JS 对象 — 只使用共享值和基本类型
scrollEventThrottle={16}— 60fps 滚动事件,保证动画流畅