<div class='type'>Function</div>


<a id='references'></a>


<h2 id="animatable-initialvalue">Animatable</h2>

<div class='sourceset sourceset-common'>Common</div>


```kotlin
@RememberInComposition
public fun Animatable(initialValue: Color): Animatable<Color, AnimationVector4D>
```


This `Animatable` function creates a Color value holder that automatically animates its value
when the value is changed via `animateTo`. `Animatable` supports value change during an ongoing
value change animation. When that happens, a new animation will transition `Animatable` from its
current value (i.e. value at the point of interruption) to the new target. This ensures that the
value change is *always* continuous using `animateTo`. If `spring` animation (i.e. default
animation) is used with `animateTo`, the velocity change will be guaranteed to be continuous as
well.

Unlike `AnimationState`, `Animatable` ensures mutual exclusiveness on its animation. To do so,
when a new animation is started via `animateTo` (or `animateDecay`), any ongoing animation job
will be cancelled via a `CancellationException`.

`Animatable` also supports animating data types other than `Color`, such as Floats and generic
types. See `androidx.compose.animation.core.Animatable` for other variants.

#### Parameters

| | |
| --- | --- |
| initialValue | initial value of the `Animatable` |