Build apps faster with our new App builder! Check it out →

windowInsetsStartWidth

Common

Modifier in Compose Foundation Layout

Sets the width to that of [insets] at the [start][androidx.compose.ui.Alignment.Start] of the screen, using either [left][WindowInsets.getLeft] or [right][WindowInsets.getRight], depending on the [LayoutDirection].

When used, the [WindowInsets][android.view.WindowInsets] will respect the consumed insets from [windowInsetsPadding] and [consumeWindowInsets], but won't consume any insets.

Last updated:

Installation

dependencies {
   implementation("androidx.compose.foundation:foundation-layout:1.8.0-alpha04")
}

Overloads

@Stable
fun Modifier.windowInsetsStartWidth(insets: WindowInsets)

Code Example

insetsStartWidthSample

fun insetsStartWidthSample() {
    class SampleActivity : ComponentActivity() {
        override fun onCreate(savedInstanceState: Bundle?) {
            WindowCompat.setDecorFitsSystemWindows(window, false)
            super.onCreate(savedInstanceState)
            setContent {
                Box(Modifier.fillMaxSize()) {
                    // Background for navigation bar at the start
                    Box(
                        Modifier.windowInsetsStartWidth(WindowInsets.navigationBars)
                            .fillMaxHeight()
                            .align(Alignment.CenterStart)
                            .background(Color.Red)
                    )
                    // app content
                }
            }
        }
    }
}
by @alexstyl