# RemoteButtonGroup

## Functions summary

|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable @https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/layout/RemoteComposable https://developer.android.com/reference/kotlin/androidx/wear/compose/remote/material3/RemoteButtonGroup.composable#RemoteButtonGroup(androidx.compose.remote.creation.compose.modifier.RemoteModifier,androidx.compose.remote.creation.compose.state.RemoteDp,androidx.compose.remote.creation.compose.layout.RemotePaddingValues,androidx.compose.remote.creation.compose.layout.RemoteAlignment.Vertical,kotlin.Function1)( modifier: https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/modifier/RemoteModifier, spacing: https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/state/RemoteDp, contentPadding: https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/layout/RemotePaddingValues, verticalAlignment: https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/layout/RemoteAlignment.Vertical, content: @https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/layout/RemoteComposable @https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/layout/RemoteRowScope.() -> https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html )` Layout component to implement an expressive group of buttons in a row. |

## Functions

### RemoteButtonGroup

Artifact: [androidx.wear.compose.remote:remote-material3](https://developer.android.com/jetpack/androidx/releases/wear-compose-remote) [View Source](https://cs.android.com/search?q=file:androidx/wear/compose/remote/material3/RemoteButtonGroup.kt+function:RemoteButtonGroup)

```
@Composable
@RemoteComposable
fun RemoteButtonGroup(
    modifier: RemoteModifier = RemoteModifier,
    spacing: RemoteDp = RemoteButtonGroupDefaults.Spacing,
    contentPadding: RemotePaddingValues = RemoteButtonGroupDefaults.fullWidthPaddings(),
    verticalAlignment: RemoteAlignment.Vertical = RemoteAlignment.CenterVertically,
    content: @RemoteComposable @Composable RemoteRowScope.() -> Unit
): Unit
```

Layout component to implement an expressive group of buttons in a row.

Example of 3 buttons, the middle one bigger:

```kotlin
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.Call
import androidx.compose.material.icons.filled.Favorite
import androidx.compose.material.icons.filled.MailOutline
import androidx.compose.remote.creation.compose.capture.RemoteImageVector
import androidx.compose.remote.creation.compose.capture.toRemoteImageVector
import androidx.compose.remote.creation.compose.modifier.RemoteModifier
import androidx.compose.remote.creation.compose.modifier.fillMaxWidth
import androidx.wear.compose.remote.material3.RemoteButtonGroup

RemoteButtonGroup(modifier = modifier.fillMaxWidth()) {
    Button(Icons.Filled.MailOutline.toRemoteImageVector(), RemoteModifier.weight(1f))
    Button(Icons.Filled.Favorite.toRemoteImageVector(), RemoteModifier.weight(1f))
    Button(Icons.Filled.Call.toRemoteImageVector(), RemoteModifier.weight(1f))
}
```

| Parameters |
|---|---|
| `modifier: https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/modifier/RemoteModifier = RemoteModifier` | Modifier to be applied to the button group |
| `spacing: https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/state/RemoteDp = RemoteButtonGroupDefaults.Spacing` | the amount of spacing between buttons |
| `contentPadding: https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/layout/RemotePaddingValues = RemoteButtonGroupDefaults.fullWidthPaddings()` | The spacing values to apply internally between the container and the content |
| `verticalAlignment: https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/layout/RemoteAlignment.Vertical = RemoteAlignment.CenterVertically` | the vertical alignment of the button group's children. |
| `content: @https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/layout/RemoteComposable @https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable https://developer.android.com/reference/kotlin/androidx/compose/remote/creation/compose/layout/RemoteRowScope.() -> https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | the content and properties of each button. The UX guidance is to use no more than 3 buttons within a `https://developer.android.com/reference/kotlin/androidx/wear/compose/remote/material3/RemoteButtonGroup.composable#RemoteButtonGroup(androidx.compose.remote.creation.compose.modifier.RemoteModifier,androidx.compose.remote.creation.compose.state.RemoteDp,androidx.compose.remote.creation.compose.layout.RemotePaddingValues,androidx.compose.remote.creation.compose.layout.RemoteAlignment.Vertical,kotlin.Function1)`. |