Expoでのアニメーション構築
初回応答
このスキルが特定の質問なしに最初に呼び出された場合、以下のみを応答してください:
実機で正しく感じられるExpoとReact Nativeのアニメーションを構築する準備ができています。私の知識はEmil Kowalskiのアニメーション哲学に基づいています。
ユーザーが質問するまで、それ以上の情報は提供しないでください。
React Nativeのための構築スキルです。モーションのリクエストを、実機での厳しいレビューに耐える実装に変換します。シミュレーターでも、開発モードのフラッグシップスマートフォンでもありません。
モバイルはアニメーションに関して3つのことを変えます。このスキルのすべてはこれらに従います:
- ホバーは存在しない。 ウェブがホバーに置くすべてのアフォーダンスは、プレス、位置、または何もないところに存在しなければなりません。
- 2つのランタイムがある。 ワークレット(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未満、またはなし |
| 時々 — シート、モーダル、トースト、オンボーディングステップ | 標準アニメーション |
| 稀 / 初回のみ — 成功状態、空状態のイラスト、祝福 | 喜びの予算はここにあります |
タブスイッチはスライドしない。 タブはピアであり、階層ではありません — スライドはそこにない深さを暗示し、ユーザーはセッション中にそれを何十回も支払います。 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を先にしてください。- Androidの影は
elevationであり、elevationをアニメーション化するとフレームごとに影が再レンダリングされます。 代わりに、事前に影をつけたレイヤーのopacityをアニメーション化してください。 - 決して
BlurViewの強度をアニメーション化しないでください。 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向けの強いイーズアウト
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 |
| シート、モーダル、ドロワー | スプリング、~300ms知覚 |
| 画面遷移 | プラットフォームデフォルト — 上書きしないでください |
モバイルUIアニメーションは、ウェブと同様に300ms未満に保ちます。プラットフォーム自身のトランジションはより長いですが(iOSプッシュは350ms)、ナビゲーションではプラットフォームに合わせ、それ以外ではそれを上回ります。
6. JSスレッドから遠ざける
これはモバイル固有の技術であり、ほとんどのReact Nativeモーションが死ぬ場所です。
- ジェスチャーやスクロールハンドラから決して
setStateしないでください。 フレームごとに1回のReactレンダリングは、RNアプリにおけるカクつきの最大の原因です。共有値 →useAnimatedStyle、そしてReactはまったく再レンダリングしません。 onUpdateやスクロールハンドラ内でRNランタイムにスケジュールバックしないでください。 非推奨のrunOnJS(fn)(...args)に代わるReanimated 4のscheduleOnRN(fn, ...args)(react-native-workletsから)は、RNランタイム呼び出しをキューに入れます。onUpdate内では毎秒60~120回になります。これはonEndか、値がしきい値を超えたときに発火するuseAnimatedReactionに属します。- レンダリング中に共有値を読み取らないでください(JSX内の
translateY.get())。それは決して更新されないスナップショットであり、静かに非同期になります。レンダリング中に書き込みもしないでください — 再調整の途中で発火し、あなたが引き起こさなかった再レンダリングが書き込みを再生します。ワークレット、ハンドラ、エフェクト内でのみ共有値に触れてください。 .valueではなく、.get()/.set()を使用してください。 同じ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により、指が数ピクセルずれても、ユーザーが意図したプレスがキャンセルされないようにします。- MaterialスタイルのアプリでのみAndroidリップルを使用する。 カスタムデザインのアプリでは、両方のプラットフォームで同じスケールを使用する方が、片方だけリップルを使用するよりも一貫性があります。
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 });
モーション軽減はより少なく、より穏やかにを意味し、ゼロではありません。状態変化を説明する不透明度や色の変化は保持し、移動、スケール、パララックス、オーバーシュートは削除します。画面遷移は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プロジェクトのみが、手動でプラグインを追加します。 -
react-native-gesture-handlerが正しく設定されていることを確認する:ルートにGestureHandlerRootView。Expo Routerはデフォルトでこれを行いますが、ベアプロジェクトの場合は自分でラップする必要があります。 -
レイアウトアニメーションはExpo SDK 52以降の安定版に含まれています。
<SkiaCanvas>内では、子に配置アニメーション (entering/exiting) を適用しないでください。代わりに手動で管理してください。 -
Lottieは
LottieViewをマウントするだけで自動的に再生されます。明示的にplay()を呼び出さないでください。
実機テストコマンド
npx expo run:ios --device # iOS実機ビルド
npx expo run:android --device # Android実機ビルド