ContentView¶

ContentView is an extension function of ComponentActivity in the :compose Android module. It serves as the entry point where the application's root Compose interface is injected.

Characteristics¶

• Not a standard @Composable: This function is equivalent to setContent {}. Therefore, it is called once during onCreate() in the Activity.
• Built-In Edge-to-Edge: Directly calls enableEdgeToEdge() so the content spans across System Bars and Navigation Bars.
• Auto Theme Wrapping: This function wraps its content in Theme directly to execute Dependency Injection for Design Tokens.
• Status Bar Layering: It uses the highest Compose z-index to render the statusBarColor, ensuring it remains visible even if you render a header (e.g. AppBar) that overlaps into the status bar insets.

API Reference¶

@OptIn(ExperimentalComponentsApi::class)
fun ComponentActivity.ContentView(
    themeMode: () -> ThemeMode = { ThemeMode.Auto },
    statusBarIconMode: () -> StatusBarIconMode = { StatusBarIconMode.Auto },
    statusBarColor: () -> Color = { Color.Transparent },
    palette: Palette? = null,
    typography: Typography = DefaultTypography,
    fontFamily: FontFamily? = null,
    sizeToken: SizeToken = SizeToken.Medium,
    dynamicColor: Boolean = false,
    appBar: (@Composable () -> Unit)? = null,
    content: @Composable () -> Unit,
)

enum class StatusBarIconMode {
    Light,
    Dark,
    Auto,
}

enum class ThemeMode {
    Light,
    Dark,
    Auto,
}

Parameters¶