アニメーション API を選択する

次の図は、アニメーションの実装に使用する API を決定する際に役立ちます。

図 1. 適切なアニメーション API を選択する方法を示すディシジョン ツリー。

次のディシジョン ツリーを使用して、ユースケースに最適なアニメーション API を選択します。

• アニメーションはアートベース（SVG または画像）ですか？
  • はい: シンプルな SVG（マイクロ アニメーション付きのアイコンなど）を使用していますか？
    • あり: AnimatedVectorDrawable。
    • 不可: サードパーティのアニメーション フレームワーク（Lottie など）。
  • いいえ: アニメーションを無限に繰り返す必要がありますか？
    • あり: rememberInfiniteTransition。
    • No: レイアウトをアニメーション化していますか？
      • はい: コンテンツが異なるコンポーザブルを切り替えていますか？
        • はい: Navigation-Compose を使用していますか？
          • 可能: enterTransition と exitTransition が設定された composable()。
          • No: AnimatedContent、Crossfade、または Pager。
        • いいえ: コンテンツの表示または非表示をアニメーション化していますか？
          • 可: AnimatedVisibility または animateFloatAsState と Modifier.alpha()。
          • いいえ: サイズ変更をアニメーション化していますか？
            • あり: Modifier.animateContentSize。
            • いいえ: 別のレイアウト プロパティ（オフセットやパディングなど）をアニメーション化していますか？
              • はい: 「プロパティは完全に独立していますか？」をご覧ください。
              • いいえ: リストアイテムをアニメーション化していますか？
                • あり: animateItemPlacement()。
      • いいえ: 複数のプロパティをアニメーション化していますか？
        • はい: プロパティは完全に独立していますか？
          • あり: animate*AsState。テキストには TextMotion.Animated を使用します。
          • いいえ: 同時に開始する必要がありますか？
            • あり: updateTransition（AnimatedVisibility、animateFloat、animateInt など）
            • なし: animateTo を含む Animatable。suspend 関数を使用して異なるタイミングで呼び出されます。
        • いいえ: アニメーションに事前定義されたターゲット値がありますか？
          • あり: animate*AsState。テキストには TextMotion.Animated を使用します。
          • いいえ: アニメーションはジェスチャー駆動型で、信頼できる唯一の情報源ですか？
            • はい: animateTo / snapTo を使用した Animatable。
            • いいえ: 状態管理のないワンショット アニメーションですか？
              • あり: AnimationState または animate。
              • いいえ: 回答が見つからない場合機能リクエストを提出してください。

図の PDF 版をダウンロードします。