直感的な理解
View ベースの Android や、ほとんどの命令型 UI ツールキットから来た人にとって、「何かをアニメーションさせる」ことは自分が実行するアクションのように感じられる。ObjectAnimator や UIViewPropertyAnimator のようなオブジェクトを取得し、duration とターゲットを渡して .start() を呼ぶ。アニメーションは View の上で動くものであり、残りのコードとは別個に存在していて、古いアニメーションが終わる前に新しいものが発火したら自分で .cancel() することを覚えておかなければならない。
animate*AsState と Animatable
は、外から見ると duration、イージングカーブ、ターゲット値という同じ種類の API に見える。しかし、その下にあるメンタルモデルは違う。
ObjectAnimatorがViewに付随しているような形で、composable にアニメーションオブジェクトが結びついているわけではない。存在するのは値であり、ある時点でのその値の読み取り結果は、最新のターゲットに向かう途中の が「今いる場所」でしかない。- 一般的なケースでは、自分で
.start()や.cancel()を呼ぶことは決してない。プレーンなmutableStateOfを変更することでターゲットを変えると、アニメーションがターゲットが動いたことに気づき、自ら再ターゲティングする。 - 飛行中にターゲットが再び変化しても(ユーザーが素早く二度タップしたときなど)、何かを停止して再開する必要はない。値は現在いる場所から新しいターゲットに向かって曲がっていくだけだ。
具体例:瞬時に切り替わる値とアニメーションする値
// jump: expanded flips instantly, size flips with it, no animation at all
var expanded by remember { mutableStateOf(false) }
val size = if (expanded) 200.dp else 100.dp
Box(Modifier.size(size).background(Color.Blue))// animated: same boolean, same target expression, but size is now a read
// of an interpolated value instead of the raw target
var expanded by remember { mutableStateOf(false) }
val size by animateDpAsState(targetValue = if (expanded) 200.dp else 100.dp)
Box(Modifier.size(size).background(Color.Blue))変わったのは size がどこから読み取られるかだけだ。expanded はどちらのバージョンでも瞬時に切り替わり続けている。「アニメーションするブール値」というものは存在しない。animateDpAsState はそのターゲットと読み取る size の間にただ挟まり、expanded にまったく触れることなく、画面に表示されるものを毎フレーム滑らかにしているだけだ。
さらなる例:Animatableは同じ仕組みを手動で行うもの
animate*AsState は便利なラッパーだ。Animatable はそのラッパーを剥がした、まったく同じアイデアであり、実際に何をしているかが見える。
var target by remember { mutableStateOf(0f) }
val offset = remember { Animatable(0f) }
LaunchedEffect(target) {
// retargets automatically: if offset is already mid-flight toward an
// older target, this cancels that run and continues from wherever
// offset currently sits, toward the new target
offset.animateTo(target, animationSpec = spring())
}
Row {
Button(onClick = { target = 0f }) { Text("0f") }
Button(onClick = { target = 120f }) { Text("120f") }
}これは、この一行がやってくれることを手作業でやっているだけだ。
val offset by animateFloatAsState(targetValue = target, animationSpec = spring())そのコードと同じように、下の二つのボタンをタップしてみてほしい。飛行中の素早いタップも含めて。カーブは同じものであり、Compose がデフォルトで使う
の spring()(Spring.StiffnessMedium、Spring.DampingRatioNoBouncy)そのものであり、それを代用する汎用的なイージングカーブではない。
offset.value = 0.0f — animating toward target 0
tap the other button mid-flight: the curve bends toward the new target instead of resetting to zero
内部的には、animateFloatAsState は Animatable を remember し、ターゲットをキーとした
を起動する。その中身は同じ animateTo 呼び出しだ。*AsState ラッパーの代わりに Animatable を直接使う理由は制御にある。animateTo は suspend 関数なので await してアニメーションが実際に収まった後にコードを実行できる。snapTo は補間をまったく行わずに値へジャンプするので、見た目のアニメーションなしに状態をリセットするのに便利だ。そして animateDecay は、固定ターゲットを追いかける代わりに、フリングが自身の運動量のもとで続くことを可能にする。
根本原理
これが値ベースのアニメーションだ。「アニメーション」とは、Animatable の値と、
がフレームごとに新しい補間値をその中へ書き込み続け、最後に与えられたターゲットに向かって、
が記述する曲線に従って動き続けている、ということにすぎない。animate*AsState はまさにそれを管理されたインスタンスにしたものだ。remember された Animatable と、ターゲットが変わるたびに animateTo(target) を呼ぶ LaunchedEffect の組み合わせにすぎない。値自体の外側に別個の「プレイヤー」オブジェクトが存在するわけではない。値そのものがアニメーションなのだ。
animate*AsState ファミリーの全体像
型付きの animate*AsState 関数はすべて、前の節と同じ Animatable + LaunchedEffect ラッパーであり、ただ特定の型用の TwoWayConverter、つまりその型を float のベクトルに変換して戻す方法を知っているピースが、あらかじめ埋め込まれているだけだ。それによってスプリングや tween が補間できる対象が得られる。
| Function | Animates | Notes |
|---|---|---|
animateFloatAsState | Float | 基本形。他の多くはこれに型を被せたもの |
animateDpAsState | Dp | Float と同じで単位でラップされているだけ |
animateIntAsState | Int | 毎フレーム整数に丸める |
animateIntOffsetAsState | IntOffset | ピクセル単位のx/y、例: Modifier.offset { } |
animateIntSizeAsState | IntSize | ピクセル単位の幅/高さ |
animateOffsetAsState | Offset | float のx/y、例: ドラッグ中の位置 |
animateSizeAsState | Size | float の幅/高さ |
animateRectAsState | Rect | 四辺すべてを一緒にアニメーション |
animateColorAsState | Color | 残りとは別の animation アーティファクトに存在する。Color は animation-core が本来依存を避けているグラフィックスモジュールを引き込んでしまうため |
animateValueAsState | 任意の T | 上記すべての基盤となる汎用形。独自の TwoWayConverter<T, V> を渡せば、名前付き関数がカバーしない型をアニメーションできる |
animateBooleanAsState は存在しないが、これは見落としではない。Boolean には補間する対象となる中間がない。二つの値のどちらかであり、その間には何もないのだ。true と false の「間」をアニメーションさせると言っても、実際には常に二つの状態を表す別の型、Float のアルファ値や Color、Dp のサイズなどをアニメーションさせていることになり、ブール値はその値がどのターゲットへ向かうべきかを決めるだけだ。
実際にこれらを使う場面
- 押下フィードバック。
interactionSource.collectIsPressedAsState()からscaleやalphaを駆動するanimateFloatAsState。押された瞬間にボタンが視覚的に縮んだり暗くなったりし、離すとスプリングで戻る。 - 展開/折りたたみ。 カードの
height(またはModifier.size)にかけるanimateDpAsState。コンテンツを切り替える同じブール値でトグルすることで、二つの高さの間を瞬間切り替えするのではなく、コンテナがリサイズされる。 - 選択のハイライト。 リスト項目の
backgroundにかけるanimateColorAsState。選択フラグでトグルすることで、選択を切り替えるとハイライト色がクロスフェードし、パッと点滅することがなくなる。 - ドラッグで消す操作。
Modifier.pointerInputの中で直接駆動するAnimatable。ドラッグのデルタごとにsnapToを呼んで指と正確に1:1で追従させ、離した時点でドラッグが閾値を超えていたかに応じてanimateTo(0f)で戻すかanimateDecayで画面外へ飛ばす。 - 離散的なジャンプで進まないプログレス。 プログレスバーの割合にかける
animateFloatAsState。裏で保持する状態は実際の処理が報告する粒度だけで更新し、滑らかさはバー自体が供給する仕組みにする。 - モーションが実際に終わってから一度だけコードを実行する。 コルーチン内で
animateToを await するAnimatable。スナックバーの dismiss コールバックやボタンの再有効化が、ターゲット状態が切り替わった瞬間ではなく、スライドアウトが視覚的に完了したタイミングで発火する。
他のフレームワークでも:同じ根本原理、違う名前
- Flutter:まったく同じ分割が、ただ名前が違うだけで存在する。
AnimatedContainer、AnimatedOpacity、その他のImplicitlyAnimatedWidgetファミリーはanimate*AsStateと同じように動く。ターゲットのプロパティを変更すれば、ウィジェットが自動的にそこへ向かって再構築される。AnimationControllerとTweenの組み合わせはAnimatableの相当品だ。同じ補間の仕組みが基盤にあり、開始・停止・飛行中の値の読み取りを直接制御できる。 - CSS transitions:要素に
transition: width 0.3s easeを設定すると、アニメーションを「開始」するために何かを呼ぶことは一切ない。widthを変更するだけで(例えばクラスをトグルすることで)、ブラウザは古い計算値から新しい値へ補間する。これはanimateDpAsStateが新しいtargetValueに反応する再ターゲティングの挙動と同じだ。 - SwiftUI:
.animation(_:value:)は暗黙的な、animate*AsState形の半分だ。@Stateプロパティに結びつければ、そのプロパティへの変更はすべて自動的にアニメーションする。明示的な状態変更を包むwithAnimation { }はAnimatable形の半分だ。やはり値をアニメーションさせているが、modifier に変更を監視させるのではなく、自分でトリガーしスコープを決める。
実際にここで引っかかるところ
LaunchedEffect を間違ったものでキーイングしてしまう
// wrong: Unit never changes, so this effect runs once on first
// composition and never again. offset.animateTo runs exactly once,
// toward whatever target happened to be at that moment.
LaunchedEffect(Unit) {
offset.animateTo(target)
}// right: keyed on target, so the effect relaunches, and retargets,
// every time target actually changes
LaunchedEffect(target) {
offset.animateTo(target)
}最初のバージョンでは、target への以後の変更はすべて黙って無視される。何もブロックを再トリガーしないからだ。Animatable は自分の値が変わったことを知らない。その値をキーにした LaunchedEffect だけがそれを知っている。
Animatable の周りで remember を忘れる
// wrong: a brand-new Animatable(0f), reset to 0f, on every recomposition
val offset = Animatable(0f)// right: the same instance survives recomposition, so it can actually
// finish animating instead of restarting from 0f each time
val offset = remember { Animatable(0f) }remember がないと、値は実際にはターゲットへのアニメーションを完了できない。毎回ゼロから再作成されて再起動し続け、ジッターのように見えたり、開始地点付近に張り付いたように見えたりする。
同じターゲットの値をアニメーションさせた読み取りと生の読み取りを混在させる
// mismatch: color crossfades, but size jumps instantly, even though
// both are supposedly animating off the same `selected` boolean
val color by animateColorAsState(if (selected) Color.Blue else Color.Gray)
val size = if (selected) 56.dp else 48.dpこれは本稿の最初の例と同じバグであり、composable が同じターゲットに駆動される複数のプロパティを持つようになったときに、うっかり再発したものだ。修正の仕方もその例と同じで、size も animateDpAsState に通すことだ。
実際に使うべきメンタルモデル
Compose にアニメーションを再生するよう指示しているわけではない。新しいターゲット値を渡しているだけで、その下にある Animatable が、最後に渡されたターゲットに向けて補間を続けているのだ。



