# SpatialShortNavigationBar

## Functions summary

|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `@https://developer.android.com/reference/kotlin/androidx/compose/material3/ExperimentalMaterial3ExpressiveApi @https://developer.android.com/reference/kotlin/androidx/xr/compose/material3/ExperimentalMaterial3XrApi @https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable https://developer.android.com/reference/kotlin/androidx/xr/compose/material3/SpatialShortNavigationBar.composable#SpatialShortNavigationBar(androidx.compose.ui.Modifier,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,kotlin.Function0)( modifier: https://developer.android.com/reference/kotlin/androidx/compose/ui/Modifier, containerColor: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, contentColor: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color, content: @https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable () -> https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html )` XR-specific [Material Design short navigation bar]("https://m3.material.io/components/navigation-bar/overview"). |

## Functions

### SpatialShortNavigationBar

Artifact: [androidx.xr.compose.material3:material3](https://developer.android.com/jetpack/androidx/releases/xr-compose-material3) [View Source](https://cs.android.com/search?q=file:androidx/xr/compose/material3/ShortNavigationBar.kt+function:SpatialShortNavigationBar) Added in [1.0.0-alpha17](https://developer.android.com/jetpack/androidx/releases/xr-compose-material3#1.0.0-alpha17)

```
@ExperimentalMaterial3ExpressiveApi
@ExperimentalMaterial3XrApi
@Composable
fun SpatialShortNavigationBar(
    modifier: Modifier = Modifier,
    containerColor: Color = ShortNavigationBarDefaults.containerColor,
    contentColor: Color = ShortNavigationBarDefaults.contentColor,
    content: @Composable () -> Unit
): Unit
```

XR-specific [Material Design short navigation bar]("https://m3.material.io/components/navigation-bar/overview").

Short navigation bars offer a persistent and convenient way to switch between primary destinations in an app.

The recommended configuration of the `https://developer.android.com/reference/kotlin/androidx/xr/compose/material3/SpatialShortNavigationBar.composable#SpatialShortNavigationBar(androidx.compose.ui.Modifier,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,kotlin.Function0)` in an XR environment is three to six `https://developer.android.com/reference/kotlin/androidx/compose/material3/ShortNavigationBarItem.composable#ShortNavigationBarItem(kotlin.Boolean,kotlin.Function0,kotlin.Function0,kotlin.Function0,androidx.compose.ui.Modifier,kotlin.Boolean,androidx.compose.material3.NavigationItemIconPosition,androidx.compose.material3.NavigationItemColors,androidx.compose.foundation.interaction.MutableInteractionSource)`s, each representing a singular destination.

See `https://developer.android.com/reference/kotlin/androidx/compose/material3/ShortNavigationBarItem.composable#ShortNavigationBarItem(kotlin.Boolean,kotlin.Function0,kotlin.Function0,kotlin.Function0,androidx.compose.ui.Modifier,kotlin.Boolean,androidx.compose.material3.NavigationItemIconPosition,androidx.compose.material3.NavigationItemColors,androidx.compose.foundation.interaction.MutableInteractionSource)` for configurations specific to each item, and not the overall `https://developer.android.com/reference/kotlin/androidx/xr/compose/material3/SpatialShortNavigationBar.composable#SpatialShortNavigationBar(androidx.compose.ui.Modifier,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,kotlin.Function0)` component.

| Parameters |
|---|---|
| `modifier: https://developer.android.com/reference/kotlin/androidx/compose/ui/Modifier = Modifier` | the `https://developer.android.com/reference/kotlin/androidx/compose/ui/Modifier` to be applied to this navigation bar |
| `containerColor: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color = ShortNavigationBarDefaults.containerColor` | the color used for the background of this navigation bar. Use `https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color#Transparent()` to have no color |
| `contentColor: https://developer.android.com/reference/kotlin/androidx/compose/ui/graphics/Color = ShortNavigationBarDefaults.contentColor` | the color for content inside this navigation bar. |
| `content: @https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable () -> https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | the content of this navigation bar, typically `https://developer.android.com/reference/kotlin/androidx/compose/material3/ShortNavigationBarItem.composable#ShortNavigationBarItem(kotlin.Boolean,kotlin.Function0,kotlin.Function0,kotlin.Function0,androidx.compose.ui.Modifier,kotlin.Boolean,androidx.compose.material3.NavigationItemIconPosition,androidx.compose.material3.NavigationItemColors,androidx.compose.foundation.interaction.MutableInteractionSource)`s |