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

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

図 1. 適切なアニメーション API を選択する方法の決定木

以下のディシジョン ツリーに沿って質問に答えて、ユースケースに最も適したアニメーション API を選択します。

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

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