React Native Reanimated は何をしますか?
概要
Reanimatedは、アニメーションをネイティブUIスレッドで実行します。JSブリッジのボトルネックやフレーム落ちがなく、JavaScriptスレッドがビジーな状態でもアニメーションは60fpsを維持します。'ワークレット'と呼ばれる、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">My App</Text>
</Animated.View>
<Animated.ScrollView onScroll={scrollHandler} scrollEventThrottle={16}>
{/* コンテンツ */}
</Animated.ScrollView>
</>
);
}
使用例
例1: カードスワイプインターフェースの構築
ユーザープロンプト: "スムーズなアニメーションでTinder風のカードスワイプインターフェースを構築してください。"
エージェントは、パンジェスチャ、スワイプ方向に基づく回転、スナップバック用のスプリングアニメーション、カード削除時のレイアウトトランジションを備えたカードスタックを作成します。
例2: アニメーションボトムシート
ユーザープロンプト: "ドラッグして引き上げ、特定の位置にスナップするボトムシートを作成してください。"
エージェントは、スナップポイント付きのパンジェスチャ、高さの共有値、スムーズなスナップのためのスプリングアニメーションを使用します。
ガイドライン
- アニメーション状態には共有値を使用 —
useSharedValueはUIスレッドで実行 - 動的スタイルには
useAnimatedStyle— UIスレッドで再計算 - 自然な動きには
withSpring— 正確な継続時間が必要な場合はwithTiming - ワークレットからJSを呼び出すには
runOnJS— 必要な場合にJSスレッドにブリッジ - Gesture Handlerとの統合 —
Gesture.Pan(),Gesture.Pinch()など - レイアウトアニメーションは宣言的 — Animatedコンポーネントの
entering,exitingプロパティ - 値のマッピングには
interpolate— スクロール位置をopacity、scaleなどにマッピング - Babelプラグインは最後に記述 —
react-native-reanimated/pluginをplugins配列の末尾に - ワークレット内でJSオブジェクトにアクセスしない — 共有値とプリミティブのみ
scrollEventThrottle={16}— スムーズなアニメーションのために60fpsのスクロールイベント