# SpatialElevationLevel

Artifact: [androidx.xr.compose:compose](https://developer.android.com/jetpack/androidx/releases/xr-compose) [View Source](https://cs.android.com/search?q=file:androidx/xr/compose/spatial/SpatialElevationLevel.kt+class:androidx.xr.compose.spatial.SpatialElevationLevel) Added in [1.0.0-beta02](https://developer.android.com/jetpack/androidx/releases/xr-compose#1.0.0-beta02)


```
object SpatialElevationLevel
```

<br />

*** ** * ** ***

Defines standardized resting elevation levels for spatial UI elements. These levels provide a consistent visual hierarchy.

Elevation levels range from `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#Level0()` (imperceptible, for smooth transitions) to `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#Level5()` (highest recommended).

## Summary

| ### Public properties |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/unit/Dp` | `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#ActivityDefault()` Default elevation for the overall activity or screen background. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/unit/Dp` | `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#DialogDefault()` Default elevation specifically for Dialogs, typically the highest. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/unit/Dp` | `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#Level0()` The base elevation, used for the main content panel. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/unit/Dp` | `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#Level1()` Elevation for secondary UI elements like orbiters that float above the main panel. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/unit/Dp` | `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#Level2()` Elevation for transient UI elements such as Menus (Dropdown, Autocomplete, Select) and Orbiters Menus. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/unit/Dp` | `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#Level3()` An intermediate elevation. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/unit/Dp` | `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#Level4()` A higher intermediate elevation. |
| `https://developer.android.com/reference/kotlin/androidx/compose/ui/unit/Dp` | `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#Level5()` The highest standard elevation, typically reserved for elements like `SpatialDialog`. |

## Public properties

### ActivityDefault

```
val ActivityDefault: Dp
```

Default elevation for the overall activity or screen background. Usually no elevation. Value: `0.dp`.

### DialogDefault

```
val DialogDefault: Dp
```

Default elevation specifically for Dialogs, typically the highest. Mirrors `https://developer.android.com/reference/kotlin/androidx/xr/compose/spatial/SpatialElevationLevel#Level5()`. Value: `56.dp`.

### Level0

```
val Level0: Dp
```

The base elevation, used for the main content panel. Visually indistinct from no elevation (0.dp) but crucial for animation and transition purposes.

### Level1

```
val Level1: Dp
```

Elevation for secondary UI elements like orbiters that float above the main panel. Value: `16.dp`.

### Level2

```
val Level2: Dp
```

Elevation for transient UI elements such as Menus (Dropdown, Autocomplete, Select) and Orbiters Menus. Value: `24.dp`.

### Level3

```
val Level3: Dp
```

An intermediate elevation. No assigned to default components but available for custom layering. Value: `32.dp`.

### Level4

```
val Level4: Dp
```

A higher intermediate elevation. Not assigned to default components but available for custom layering. Value: `40.dp`.

### Level5

```
val Level5: Dp
```

The highest standard elevation, typically reserved for elements like `SpatialDialog`. Value: `56.dp`.