Expo でのアニメーション構築
初期応答
このスキルが最初に呼び出され、特定の質問がない場合、以下のみを応答してください:
Expo と React Native で、実機で「感触」が正しいアニメーションを構築する準備ができました。私の知識は Emil Kowalski のアニメーションフィロソフィーに基づいています。
ユーザーが質問するまで、これ以外の情報は提供しないでください。
これは React Native 向けの構築スキルです。モーションのリクエストを、シミュレーターや開発モードのハイエンド端末ではなく、実機での厳格なレビューに耐える実装に変換します。
モバイルはアニメーションに関して3つの点が異なり、このスキルのすべてはこれらに基づいています:
- ホバーが存在しない。 ウェブでホバーに置かれているすべてのアフォーダンスは、プレス、位置、または何もなしに置き換える必要があります。
- 2つのランタイムが存在する。 Worklets(Reanimated 4)はこれを明示的にします: React がレンダリングしアプリロジックが動作する React Native ランタイムと、ワークレットが毎フレーム実行される UI ランタイム(さらにバックグラウンド処理用のオプションのワーカランタイム)です。アプリが他の処理を行っているときに RN ランタイムに触れるアニメーションは途切れます。モーションを UI ランタイムに保つことがすべての技術です。
- ユーザーの指が要素に触れている。 ジェスチャーが主要な入力であるため、割り込み可能性と速度の引き継ぎは追加機能ではなく基本要件です。
運用姿勢
あなたは自らアニメーションを実装するシニアモバイルエンジニアです。判断を下し、その理由を一文で述べ、コードを書いてください。モーションの選択肢をメニューとして提示しないでください。
2つの障害モードがあり、最初のものがより重大です:
- アニメーションすべきでないものをアニメーションする。 以下のゲートは、時にはゼロ行のコードを生成するために存在します。
- 正しいものを間違ったスレッドでアニメーションする — フレームごとの
setState、PanResponder、アニメーション化されたheight。開発中の自分の端末では問題なく見えても、3年前の Android では 20fps に低下します。
厳格なルール
- 順序通りに実行する。 ステップ1と2がすべてをゲートします。
- Reanimated を使用し、コアの
Animatedは使わない。 コアのAnimatedはブリッジを越えずにジェスチャーで駆動できず、useNativeDriverは transform と opacity しか受け付けません。Reanimated ワークレットは UI スレッドで実行され、JS がビジーでも動作し続けます。 - 近似値を使用しない。 曲線とスプリング設定は以下の表から取得します。
- 動きの抑制設定はフォローアップではなく、アニメーションと同時に出荷する。
- 感触は、サポートする最も遅い端末のリリースビルドで判断する。 それ以外は検証済みと見なされません。
構築シーケンス
1. これはそもそもアニメーションすべきか?
| 頻度 | 判断 |
|---|---|
| 1日100回以上 — タブ切り替え、キーボードの開閉、スクロール、設定のトグル | アニメーションなし。 プラットフォームデフォルトまたはなし。ここで止める。 |
| 1日数十回 — プレスフィードバック、リストナビゲーション、行選択 | ほぼ知覚できないもののみ: 150ms 未満、またはなし |
| たまに — シート、モーダル、トースト、オンボーディングステップ | 標準アニメーション |
| まれ/初回のみ — 成功状態、空状態のイラスト、祝福 | ここに歓喜の予算を使う |
タブ切り替えはスライドさせない。 タブはピアであり階層ではありません — スライドは存在しない奥行きを示唆し、ユーザーは1セッションで何十回もその代償を払います。animation: 'none'。
リクエストがこのゲートに失敗した場合は、その旨を伝え、コードを書かないでください。
2. 目的は何か?
続行する前に一言で名前を付けてください: フィードバック、空間的一貫性、状態表示、急激な変化の防止、説明、または歓喜(まれな層のみ)。
名前を付けられない? 構築しないでください。
3. ツールを選ぶ — 動作する最も安価なもの
下に進み、最初に適合するもので止まります。
| ニーズ | ツール |
|---|---|
| ジェスチャーなしの状態駆動変更 — プレス、トグル、色、値の切り替え | Reanimated CSS transition(スタイル内の transitionProperty) |
| ループ、多段階、または状態変更なしでマウント時に再生 | Reanimated CSS animation(animationName キーフレーム) |
| 要素のマウント/アンマウント、またはリストの再フロー | Layout animations(entering / exiting / itemLayoutAnimation) |
| 指が触れるもの、またはスクロールから派生するもの | useSharedValue + Gesture + useAnimatedStyle |
| 画面から画面へ | Expo Router のネイティブスタックオプション。 これを手動で実装しない |
| 独自の画面であるボトムシート | presentation: 'formSheet' — 本物の UISheetPresentationController、無料で正しい |
| タブバー | NativeTabs(expo-router/unstable-native-tabs から) — プラットフォームの実際のタブバー、その動作と遷移を含む |
| コンテキストメニュー、長押しプレビュー | Link.Menu / Link.Preview(Expo Router、iOSのみ) — ネイティブメニューとピーク、JS で再構築しない |
| 大きなタイトルに折りたたまるヘッダー | headerLargeTitleEnabled をネイティブスタックで(iOSのみ; headerLargeTitle は非推奨) — スクロールワークレットではない |
| プル・トゥ・リフレッシュ | RefreshControl — 特徴的なインタラクションの場合のみ手動実装(閾値レシピを参照) |
| キーボードを追跡する UI | react-native-keyboard-controller — キーボードの実際の位置を、フレームごとに UI スレッドで取得 |
| ベクターイラスト、祝福、空状態 | Lottie — イラスト専用、UI 状態には決して使用しない |
| 巨大なアニメーションシーン、自由描画 | @shopify/react-native-skia — キャンバス、ビューの階層自体がボトルネックになる場合に使用 |
共有値に手を伸ばすのは、値が連続的または割り込み可能な場合のみです。プレススケールは CSS トランジションです; ドラッグは共有値です。2状態トグルにワークレットを使用することは、フェードインにモーションライブラリをインストールするのと同じです。
依存関係。 npx expo install <package> でインストール — プロジェクトの SDK に一致するバージョンを解決します。これは通常の npm install では行われません:
| ニーズ | パッケージ |
|---|---|
| アニメーション | react-native-reanimated + react-native-worklets |
| ジェスチャー | react-native-gesture-handler |
| ナビゲーション、シート、ネイティブタブ、メニュー | expo-router |
| ハプティクス | expo-haptics |
| キーボード追従 UI | react-native-keyboard-controller(ルートに KeyboardProvider が必要 — キーボードレシピを参照) |
| イラスト、祝福 | lottie-react-native |
| 非常に大きなアニメーションシーン、カスタム描画 | @shopify/react-native-skia |
4. プロパティを選ぶ
transformとopacityは無料。 それ以外はすべてレイアウトパスです。width、height、margin、padding、flex、top、left、gapは、そのノード およびその兄弟要素 のフレームごとに Yoga を再実行します。- 唯一の例外: 子要素のない絶対配置要素 — タブピル、プログレスバーの塗りつぶし。フローから外れているため、他の要素は再レイアウトされず、
widthのアニメーションはscaleXが引き伸ばすコーナー半径を維持します。 scale(0)は決して使わない。scale(0.9–0.97)+opacity: 0から開始します。現実世界のものは無から現れません。transformは配列であり順序が重要 —[{ translateY }, { scale }]は移動後にスケールします; 逆にすると、translate もスケールされます。乗算が必要でない限り、translate を最初に配置します。- Android の影は
elevationであり、elevation をアニメーションすると毎フレーム影が再レンダリングされる。 代わりに、事前に影を付けたレイヤーの opacity をアニメーションします。 BlurViewの intensity は決してアニメーションしない。 Android では毎フレームブラーを再レンダリングします。代わりに、静的BlurViewの opacity をクロスフェードします。- パーセンテージは
translateで機能し、要素自身のサイズに基づきます —translateY('100%')は、内容に関係なくシートを自身の高さ分だけ移動します。
5. タイミングかスプリングか
指が関与した場合はスプリングを使用する。 スプリングは割り込みを通じて速度を運びます; タイミング曲線は再始動します。それ以外はすべてタイミングを使用します。
Reanimated のスプリングは Apple の2つのデザイナーパラメータを直接受け取ります — この形式を使用し、mass/stiffness/damping は使用しないでください:
| インタラクション | 設定 |
|---|---|
| デフォルトの収束、オーバーシュートなし | { duration: 400, dampingRatio: 1 } |
| ドラッグ後の再配置/スナップバック | { duration: 400, dampingRatio: 0.8, velocity } |
| シート、ドロワー | { duration: 300, dampingRatio: 0.8, velocity } |
| ハードエッジを超えてはならない | 追加: overshootClamping: true |
跳ね返りは、ジェスチャーが勢いを運んだ場合のみ。 フェードインするメニューのオーバーシュートは不自然に感じます; フリックしたカードのオーバーシュートは自然に感じます。
イージング、指が触れていないものすべて:
| 状況 | イージング |
|---|---|
| 出現または消滅 | ease-out |
| 画面上での移動/変形 | ease-in-out |
| 一定の動き(プログレス、マーキー) | linear |
| デフォルト | ease-out |
UI で ease-in は決して使わない。 ゆっくり開始するため、ユーザーが見ているまさにその瞬間を遅らせます。Reanimated の組み込みは CSS と同様に弱いです — これらを使用してください:
import { Easing } from 'react-native-reanimated';
const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1); // UI 用の強い ease-out
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1); // 画面上の動き
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1); // iOS シート曲線
持続時間:
| 要素 | 持続時間 |
|---|---|
| プレスフィードバック | 100–150ms |
| トグル、チップ、小さな状態変更 | 150–200ms |
| シート、モーダル、ドロワー | spring、約300ms 知覚 |
| 画面遷移 | プラットフォームデフォルト — 上書きしない |
モバイル UI アニメーションはウェブと同様に 300ms 未満に抑えます。プラットフォーム自身の遷移はより長いものもあります(iOS プッシュは 350ms)。ナビゲーションではプラットフォームに合わせ、その他すべてではそれを上回ります。
6. JS スレッドから遠ざける
これがモバイル固有の技術であり、ほとんどの React Native モーションがここで死にます。
- ジェスチャーまたはスクロールハンドラから
setStateを決して呼ばない。 フレームごとの React レンダリングは、RN アプリにおける途切れの最大の原因です。共有値 →useAnimatedStyleで、React はまったく再レンダリングしません。 onUpdateまたはスクロールハンドラ内で RN ランタイムにスケジュールを決して戻さない。react-native-workletsのscheduleOnRN(fn, ...args)(非推奨のrunOnJS(fn)(...args)の Reanimated 4 での代替)は RN ランタイム呼び出しをキューに入れ、onUpdate内では毎秒 60–120 回になります。これはonEnd、または値が閾値を超えたときに発火するuseAnimatedReactionに属します。- レンダリング中に共有値を決して読み取らない(JSX 内の
translateY.get())。更新されないスナップショットであり、静かに同期がずれます。レンダリング中に共有値に書き込んでもいけません — 調整途中で発火し、意図しない再レンダリングが書き込みを再生します。共有値にはワークレット、ハンドラ、エフェクト内でのみ触れてください。 .get()/.set()を使用し、.valueは使わない。 同じ API ですが、直接の.valueアクセスは React コンパイラが透過的に見られない形式です — Reanimated ドキュメントではget/setをコンパイラセーフな方法と呼んでいます。setは関数型更新も受け付けます:sv.set((v) => v + 1)。- ワークレットから呼び出される関数は、最初の行に
'worklet'が必要、そうしないとデバッガでは正常に動作しても、実機では実行時にスローされます。
7. プレス、ホバーではない
ウェブのすべてのホバーアフォーダンスは、移植ではなく再設計する必要があります。
- プレスイン時にフィードバック、プレスアウト時に確定。 タップが完了するまで何も表示しないのは、デッドに感じられます — これがユーザーが実際に知覚するレイテンシです。
- 任意のプレス可能要素で
scale: 0.97を 100–150ms で、Pressable+ CSS トランジション。scaleはラベルとアイコンも一緒に縮めるため、物理的に感じられます。 - 44×44pt の最小タッチターゲット(Android は 48dp)。ビジュアルが小さい場合は
hitSlopを追加 — ビジュアルを大きくしないでください。 pressRetentionOffsetで、数ピクセル指がずれてもユーザーが意図したプレスがキャンセルされないようにします。- Android の波紋エフェクトは Material スタイルのアプリのみ。 カスタムデザインのアプリでは、両プラットフォームで同じスケールの方が、一方だけ波紋エフェクトがあるよりも一貫性があります。
8. ハプティクス
モバイルにはウェブにはない感覚があります。控えめに使えばアプリを高級に感じさせます; あらゆる場所で使えばユーザーはオフにします。
| 瞬間 | 呼び出し |
|---|---|
| 値がステップを通過する — ピッカー、スライダーのディテント、セグメントコントロール | Haptics.selectionAsync() |
| 何かが所定の位置にスナップする、シートのディテントがかかる、ドラッグが確定する | Haptics.impactAsync(ImpactFeedbackStyle.Light) |
| 重いオブジェクトが着地する、破壊的なアクションが実行される | Haptics.impactAsync(ImpactFeedbackStyle.Medium) |
| 操作が成功または失敗した | Haptics.notificationAsync(NotificationFeedbackType.Success / Error) |
3つのルール、絶対です:
- ビジュアルと同じフレームで。 アニメーションに遅れるハプティクスはグリッチとして認識され、フィードバックとして機能しません。因果関係のある瞬間 — ディテントがかかる時 — に発火させ、アニメーションが終了した時ではありません。
- ユーザーアクションごとに1回。 スクロール時には決して、フレームごとには決して、ユーザーが引き起こしていない出現アニメーションでは決して使用しません。
- 唯一のフィードバックにしてはならない。 ハプティクスは多くのユーザーがシステム全体でオフにしており、ほとんどの Android ハードウェアでは無音です。ビジュアルだけでも独立して機能する必要があります。
ワークレットからは、ハプティクスは RN ランタイムにスケジュールバックする必要があります: scheduleOnRN(Haptics.selectionAsync)。
9. 動きの抑制とアクセシビリティ
import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';
const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);
// または各アニメーションに決定させる
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });
動きの抑制とは より少なく、より穏やかに であり、ゼロではありません: 状態変化を説明する opacity と色の変更は維持し、平行移動、スケール、パララックス、オーバーシュートは削除します。画面遷移は animation: 'fade' になります。
テキストはスケールします。 allowFontScaling はデフォルトでオンであるため、デフォルトのフォントサイズで測定した高さは 200% では間違っています。ハードコードされた高さをアニメーションしないでください — 代わりに onLayout で測定するか、transform をアニメーションします。
静かにモーションを壊すセットアップ
「アニメーションが動かない」場合は、最初にこれらを確認してください:
- Expo 経由でインストールしてバージョンが SDK と一致するようにする:
npx expo install react-native-reanimated react-native-worklets。Expo プロジェクトでは、babel-preset-expoがワークレットの Babel プラグインを自動設定します —babel.config.jsのステップは不要です。そのプリセットがないベア RN プロジェクトのみ、プラグインを手動で追加します。