Composable Function
animateSizeAsState
Common
```kotlin
@Composable
public fun animateSizeAsState(
targetValue: Size,
animationSpec: AnimationSpec = sizeDefaultSpring,
label: String = "SizeAnimation",
finishedListener: ((Size) -> Unit)? = null,
): State
```
Fire-and-forget animation function for `Size`. This Composable function is overloaded for
different parameter types such as `Dp`, `Color`, `Offset`,
etc. When the provided `targetValue` is changed, the animation will run automatically. If there
is already an animation in-flight when `targetValue` changes, the on-going animation will adjust
course to animate towards the new target value.
`animateSizeAsState` returns a `State` object. The value of the state object will continuously be
updated by the animation until the animation finishes.
Note, `animateSizeAsState` cannot be canceled/stopped without removing this composable function
from the tree. See `Animatable` for cancelable animations.
val size: Size by animateSizeAsState( if (selected) Size(20f, 20f) else Size(10f, 10f))
#### Parameters
| | |
| --- | --- |
| targetValue | Target value of the animation |
| animationSpec | The animation that will be used to change the value through time. Physics animation will be used by default. |
| label | An optional label to differentiate from other animations in Android Studio. |
| finishedListener | An optional end listener to get notified when the animation is finished. |
#### Returns
| | |
| --- | --- |
| | A `State` object, the value of which is updated by animation. |
Common
> **Deprecated** animate*AsState APIs now have a new label parameter added.
animateSizeAsState
```kotlin
@Composable
public fun animateSizeAsState(
targetValue: Size,
animationSpec: AnimationSpec = sizeDefaultSpring,
finishedListener: ((Size) -> Unit)? = null,
): State
```