# valueChangeAction

> Creates an [RemoteAction] that updates the value of a [MutableRemoteState] to a new [RemoteState].

## API Reference

### valueChangeAction

> Source set: JvmAndAndroid

```kotlin
public fun <T> valueChangeAction(
    remoteState: MutableRemoteState<T>,
    updatedValue: RemoteState<T>,
): RemoteAction
```

Creates an [RemoteAction](https://composables.com/jetpack-compose/androidx.compose.remote/remote-creation-compose/interfaces/RemoteAction/api.md) that updates the value of a `MutableRemoteState` to a new
`RemoteState`.

Example of toggling a `MutableRemoteState` boolean value on click:

#### Parameters

| | |
| --- | --- |
| remoteState | The mutable remote state to be updated. |
| updatedValue | The new remote state value to apply. |

#### Return

An [RemoteAction](https://composables.com/jetpack-compose/androidx.compose.remote/remote-creation-compose/interfaces/RemoteAction/api.md) representing the value change.

## Code Examples

### ClickableValueChangeSample

```kotlin
@Sampled
@Preview
@PreviewWrapper(RemoteComponentPreviewWrapper::class)
@Composable
fun ClickableValueChangeSample() {
    val isToggled = remember { MutableRemoteBoolean(false) }
    val backgroundColor = isToggled.select(Color(0xFF1E88E5).rc, Color.DarkGray.rc)
    val label = isToggled.select("Active (tap to toggle)".rs, "Inactive (tap to toggle)".rs)

    RemoteBox(
        modifier =
            RemoteModifier.clip(RemoteRoundedCornerShape(12.rdp))
                .background(backgroundColor)
                .clickable(valueChangeAction(isToggled, !isToggled))
                .padding(16.rdp),
        contentAlignment = RemoteAlignment.Center,
    ) {
        RemoteText(text = label, color = Color.White.rc)
    }
}
```
