Android Compose：如何实现无状态栏全屏Dialog并添加模糊背景？

核心思路 #

Compose默认的Dialog受系统Window布局限制，无法自动延伸到状态栏区域。需要通过自定义Dialog的Window属性，让布局突破状态栏约束，再配合模糊背景实现全屏效果。

具体实现步骤 #

• 利用DialogProperties的onCreateDialog回调，获取Dialog对应的Window实例
• 给Window添加FLAG_LAYOUT_NO_LIMITS标记，允许布局延伸到状态栏下方
• 设置状态栏透明，避免遮挡内容
• 保持Compose内容的fillMaxSize，确保模糊背景覆盖全屏

完整代码示例 #

Dialog(
    onDismissRequest = onDismiss,
    properties = DialogProperties(
        usePlatformDefaultWidth = false,
        onCreateDialog = {
            object : AlertDialog.Builder(LocalContext.current).create() {
                override fun onCreate(savedInstanceState: Bundle?) {
                    super.onCreate(savedInstanceState)
                    window?.apply {
                        // 允许布局延伸到状态栏和导航栏下方
                        addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS)
                        // 设置状态栏透明
                        statusBarColor = Color.TRANSPARENT
                        // 如果需要隐藏状态栏，可添加以下标记（可选）
                        // addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)
                    }
                }
            }
        }
    ),
) {
    BlurBackground(
        modifier = Modifier
            .fillMaxSize()
            .clickable { onDismiss() }
    ) {
        // 你的Dialog内容
    }
}

补充说明 #

• 如果你需要完全隐藏状态栏，可以取消代码中FLAG_FULLSCREEN的注释，但注意这会让状态栏完全消失，需要给内容添加顶部内边距避免被系统控件遮挡
• 若使用Android 11及以上版本，还可以配合WindowInsetsController更精细地控制状态栏显示：

  window?.insetsController?.apply {
      hide(WindowInsets.Type.statusBars())
      systemBarsBehavior = WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
  }
  

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