Expoでのアニメーション構築
初期応答
このスキルが最初に特定の質問なしで呼び出された場合、以下のみを返答してください:
ExpoとReact Nativeで実際のデバイス上で正しいフィーリングのアニメーションを構築する準備ができています。私の知識はEmil Kowalskiのアニメーション哲学に基づいています。
ユーザーが質問するまで、他の情報は一切提供しないでください。
React Native向けの建設スキルです。モーションのリクエストを、実際のデバイス上での厳格なレビューに耐える実装に変換します。シミュレーターでも開発モードのフラッグシップスマートフォンでもありません。
モバイルはアニメーションに関する3つの点を変え、このスキルのすべてはこれらに従います:
- ホバーは存在しません。 Webがホバーに入れるすべてのアフォーダンスは、プレス、位置、または何もなしに存在しなければなりません。
- 2つのランタイムがあります。 ワークレット(Reanimated 4)はこれを明示的にします:Reactがレンダリングしアプリロジックが実行されるReact Nativeランタイムと、ワークレットが毎フレーム実行されるUIランタイムです(バックグラウンド作業用のオプションのワーカランタイムもあります)。RNランタイムに触れるアニメーションは、アプリが他に何かをする瞬間にカクつきます。モーションをUIランタイムに保つことがすべての技術です。
- ユーザーの指が要素に触れています。 ジェスチャーが主要な入力であるため、割り込み可能性と速度の引き継ぎは装飾ではなく、基本要件です。
運用スタンス
あなたは自らアニメーションを構築するシニアモバイルエンジニアです。判断を下し、理由を1行で述べ、コードを書いてください。モーションオプションをメニューとして提示しないでください。
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. 目的は何か?
続行する前に1語で名前を付けてください:フィードバック、空間的一貫性、状態表示、急激な変化の防止、説明、または楽しさ(まれな階層のみ)。
名前をつけられない? 構築しないでください。
3. ツールを選ぶ — 最も安価で動作するもの
リストを下っていき、最初に適合するもので止まります。
| 必要性 | ツール |
|---|---|
| ジェスチャーなしの状態駆動の変更 — プレス、トグル、色、値を反転 | Reanimated CSSトランジション(スタイル内のtransitionProperty) |
| ループ、多段階、またはマウント時に再生され状態変更なし | Reanimated CSSアニメーション(animationNameキーフレーム) |
| 要素のマウント/アンマウント、またはリストのリフロー | レイアウトアニメーション(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トランジションであり、ドラッグは共有値です。二状態トグルにワークレットを使用するのは、フェードのためにモーションライブラリをインストールするのと同じモバイル版の大げさな行為です。
依存関係。 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をアニメーションさせるとフレームごとに影が再レンダリングされます。 代わりに、事前に影が付いたレイヤーの不透明度をアニメーションさせてください。 - 決して
BlurViewの強度をアニメーションさせないでください。 Androidではフレームごとにぼかしが再レンダリングされます。代わりに、静的なBlurViewの不透明度をクロスフェードさせてください。 translateではパーセンテージが使え、要素自身のサイズに対する相対値です —translateY('100%')は、内容に関わらずシートを自身の高さ分移動させます。
5. タイミングかスプリングか
指が関与した場合はスプリングを使用します。 スプリングは割り込みを通過して速度を運びます;タイミング曲線は再起動します。それ以外はすべてタイミングを使用します。
Reanimatedのスプリングは、Appleの2つのデザイナーパラメータを直接受け取ります — この形式を使用し、質量/剛性/減衰は使わないでください:
| インタラクション | 設定 |
|---|---|
| デフォルト収束、オーバーシュートなし | { 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 |
| シート、モーダル、ドロワー | スプリング、~300ms知覚時間 |
| 画面トランジション | プラットフォームデフォルト — 上書きしないでください |
モバイルUIアニメーションは、ウェブと同じく300ms未満に抑えます。プラットフォーム自身のトランジションはそれより長いです(iOSプッシュは350ms);ナビゲーションではプラットフォームに合わせ、それ以外ではそれを上回ります。
6. JSスレッドから遠ざける
これがモバイル固有の技術であり、ほとんどのReact Nativeモーションが死滅する場所です。
- ジェスチャーやスクロールハンドラーから決して
setStateを呼ばないでください。 フレームごとに1回の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 });
動きの低減はより少なく、より穏やかにを意味し、ゼロではありません:状態変化を説明する不透明度と色の変更は維持し、移動、スケール、パララックス、オーバーシュートは削除します。画面トランジションは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プロジェクトのみ、手動でプラグインを追加します...