React Native Reanimated 是做什麼的?
概覽
Reanimated 在原生 UI 執行緒上執行動畫——沒有 JS Bridge 瓶頸,不會掉幀。即使 JavaScript 執行緒忙碌,動畫依然能保持 60fps。它使用「worklet」——透過 JSI 在 UI 執行緒上執行的小型 JavaScript 函式。這是 React Native 中生產級動畫的標準:手勢驅動的互動、佈局轉場、基於捲動的效果以及共享元素轉場。
使用時機
- React Native 中任何超出簡單透明度/變形 (opacity/transform) 的動畫
- 手勢驅動的互動(滑動刪除、拖曳排序、兩指縮放)
- 捲動驅動的動畫(視差標頭、黏貼元素)
- 佈局動畫(項目進入/離開列表)
- 畫面間的共享元素轉場
使用說明
安裝
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">我的 App</Text>
</Animated.View>
<Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>
{/* 內容 */}
</Animated.ScrollView>
</>
);
}
範例
範例 1:建立卡片滑動介面
使用者提示:「建立一個類似 Tinder 的卡片滑動介面,動畫要流暢。」
Agent 將會建立一個卡片堆疊,包含平移手勢、根據滑動方向旋轉、彈簧動畫用於彈回,以及卡片移除時的佈局轉場。
範例 2:動畫底部面板
使用者提示:「建立一個可以拖曳向上並吸附到特定位置的底部面板。」
Agent 將會使用帶有吸附點 (snap points) 的平移手勢、用於高度的共享值,以及流暢吸附的彈簧動畫。
準則
- 使用共享值管理動畫狀態 —
useSharedValue在 UI 執行緒執行 - 使用
useAnimatedStyle處理動態樣式 — 在 UI 執行緒重新計算 - 使用
withSpring實現自然運動 — 使用withTiming實現精確持續時間 - 使用
runOnJS從 worklet 呼叫 JS — 必要時橋接到 JS 執行緒 - Gesture Handler 整合 —
Gesture.Pan(),Gesture.Pinch()等 - 佈局動畫是宣告式的 — 在 Animated 元件上使用
entering,exitingprops - 使用
interpolate進行數值映射 — 將捲動位置映射到透明度、縮放等 - Babel 插件必須放在最後 —
react-native-reanimated/plugin放在 plugins 陣列的最後 - 勿在 worklet 中存取 JS 物件 — 只能操作共享值和基本型別
scrollEventThrottle={16}— 60fps 的捲動事件,確保動畫流暢