# Box

## 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/glance/layout/Box.composable#Box(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment,kotlin.Function0)( modifier: https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier, contentAlignment: https://developer.android.com/reference/kotlin/androidx/glance/layout/Alignment, content: @https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable () -> https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html )` A layout composable with `https://developer.android.com/reference/kotlin/androidx/glance/layout/package-summary#Box(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment,kotlin.Function0)`. |

## Functions

### Box

Artifact: [androidx.glance:glance](https://developer.android.com/jetpack/androidx/releases/glance) [View Source](https://cs.android.com/search?q=file:androidx/glance/layout/Box.kt+function:Box) Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/glance#1.0.0)

```
@Composable
fun Box(
    modifier: GlanceModifier = GlanceModifier,
    contentAlignment: Alignment = Alignment.TopStart,
    content: @Composable () -> Unit
): Unit
```

A layout composable with `https://developer.android.com/reference/kotlin/androidx/glance/layout/package-summary#Box(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment,kotlin.Function0)`.

By default, the `https://developer.android.com/reference/kotlin/androidx/glance/layout/Box.composable#Box(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment,kotlin.Function0)` will size itself to fit the content, unless a `https://developer.android.com/reference/kotlin/androidx/glance/unit/Dimension` constraint has been provided. When the children are smaller than the `https://developer.android.com/reference/kotlin/androidx/glance/layout/Box.composable#Box(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment,kotlin.Function0)`, they will be placed within the box subject to the `https://developer.android.com/reference/kotlin/androidx/glance/layout/package-summary#Box(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment,kotlin.Function0)`. When the `https://developer.android.com/reference/kotlin/androidx/glance/layout/package-summary#Box(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment,kotlin.Function0)` has more than one layout child, all of the children will be stacked on top of each other in the composition order.

Note for App Widgets: `https://developer.android.com/reference/kotlin/androidx/glance/layout/Box.composable#Box(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment,kotlin.Function0)` supports up to 10 child elements. Any additional elements will be truncated from the output.

| Parameters |
|---|---|
| `modifier: https://developer.android.com/reference/kotlin/androidx/glance/GlanceModifier = GlanceModifier` | The modifier to be applied to the layout. |
| `contentAlignment: https://developer.android.com/reference/kotlin/androidx/glance/layout/Alignment = Alignment.TopStart` | The alignment of children within the `https://developer.android.com/reference/kotlin/androidx/glance/layout/Box.composable#Box(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment,kotlin.Function0)`. |
| `content: @https://developer.android.com/reference/kotlin/androidx/compose/runtime/Composable () -> https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | The content inside the `https://developer.android.com/reference/kotlin/androidx/glance/layout/Box.composable#Box(androidx.glance.GlanceModifier,androidx.glance.layout.Alignment,kotlin.Function0)`. |