Jetpack Compose全屏Dialog状态栏与导航栏灰色覆盖问题求助

问题核心是全屏Dialog默认自带半透明遮罩（Dim Layer），同时系统默认的Window配置会干扰自定义颜色的显示，按以下步骤修复：

1. 移除Dialog的灰色遮罩 #

这是颜色被覆盖的直接原因，通过DialogProperties或Window配置去掉遮罩：

方式1：Compose代码内直接配置 #

Dialog(
    onDismissRequest = { /* 关闭逻辑 */ },
    properties = DialogProperties(
        usePlatformDefaultWidth = false, // 开启全屏
        decorFitsSystemWindows = false, // 禁止系统自动调整布局，自己控制系统栏
        dismissOnBackPress = true,
        dismissOnClickOutside = true
    )
) {
    val context = LocalContext.current
    val systemUiController = rememberSystemUiController()

    LaunchedEffect(Unit) {
        // 拿到当前Activity的Window
        val window = (context as Activity).window
        window.setDimAmount(0f) // 彻底移除灰色遮罩
    }

    // 你的全屏内容
}

方式2：通过主题配置（styles.xml） #

<style name="FullScreenDialogTheme" parent="Theme.Material3.Dialog">
    <item name="android:windowDimAmount">0.0</item> <!-- 移除遮罩 -->
    <item name="android:decorFitsSystemWindows">false</item>
    <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item> <!-- 适配刘海屏 -->
</style>

在Compose中指定该主题：

Dialog(
    onDismissRequest = { /* 关闭逻辑 */ },
    theme = R.style.FullScreenDialogTheme,
    properties = DialogProperties(usePlatformDefaultWidth = false)
) {
    // 你的全屏内容
}

2. 正确设置系统栏颜色 #

结合SystemUiController和Window属性，确保颜色生效且图标可见：

@Composable
fun FullScreenDialog(
    onDismiss: () -> Unit,
    statusBarColor: Color = Color.Blue,
    navigationBarColor: Color = Color.Blue
) {
    Dialog(
        onDismissRequest = onDismiss,
        properties = DialogProperties(
            usePlatformDefaultWidth = false,
            decorFitsSystemWindows = false
        )
    ) {
        val context = LocalContext.current
        val systemUiController = rememberSystemUiController()

        LaunchedEffect(statusBarColor, navigationBarColor) {
            val window = (context as Activity).window
            window.apply {
                setDimAmount(0f)
                // 允许布局延伸到系统栏下方
                addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS)
                // 清除半透明系统栏的默认配置
                clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
                clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION)
                // 直接设置Window层面的颜色
                this.statusBarColor = statusBarColor.toArgb()
                this.navigationBarColor = navigationBarColor.toArgb()
            }

            // 同步设置系统栏图标颜色（根据背景亮度自动适配）
            val isLightStatusBar = statusBarColor.luminance() > 0.5f
            val isLightNavBar = navigationBarColor.luminance() > 0.5f
            systemUiController.apply {
                setStatusBarColor(statusBarColor, darkIcons = isLightStatusBar)
                setNavigationBarColor(navigationBarColor, darkIcons = isLightNavBar)
            }
        }

        // 内容区域：添加系统栏内边距避免内容被遮挡
        Box(
            modifier = Modifier
                .fillMaxSize()
                .background(Color.White)
                .systemBarsPadding()
        ) {
            Text(text = "全屏Dialog内容", modifier = Modifier.align(Alignment.Center))
        }
    }
}

关键注意点 #

• decorFitsSystemWindows = false：必须开启，否则系统会自动添加内边距并覆盖自定义颜色配置
• systemBarsPadding()：给内容添加内边距，避免状态栏/导航栏遮挡UI
• 图标颜色适配：通过darkIcons参数确保文字图标在浅色/深色背景下都能清晰显示

内容的提问来源于stack exchange，提问作者androidexpert35