Jetpack Compose导航：解决跳转至Dialog时底部系统栏短暂显示问题

核心原因 #

Dialog导航组件初始化过程中会临时恢复系统栏可见状态，导致通过rememberSystemUiController设置的隐藏逻辑存在执行延迟，进而出现系统栏闪现情况。需在Dialog创建的更早阶段配置Window属性，才能彻底解决问题。

方案一：在Dialog导航节点中直接操作Window（推荐） #

在dialog导航块中，通过LocalContext获取Activity的Window，在Dialog渲染前就设置InsetsController隐藏系统栏，消除延迟：

dialog(route = Screen.SettingDialog.route) {
    val context = LocalContext.current
    val window = (context as Activity).window
    
    DisposableEffect(Unit) {
        val insetsController = WindowCompat.getInsetsController(window, window.decorView)
        // 隐藏所有系统栏（状态栏+导航栏）
        insetsController.hide(WindowInsetsCompat.Type.systemBars())
        // 设置系统栏行为：仅允许通过滑动临时显示
        insetsController.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
        
        onDispose {
            // 可选：若需在Dialog销毁后恢复系统栏状态，可在此添加逻辑
        }
    }

    SettingDialogScreen(
        onDismissRequest = { navController.popBackStack(route = Screen.Main.route, inclusive = false) },
        onSignOutButtonClickListener = { navController.navigate(Screen.Sign.route) },
        onSettingScreenButtonClickListener = {
            navController.popBackStack()
            navController.navigate(Screen.Setting.route)
        },
    )
}

方案二：通过全局主题配置Dialog样式 #

在res/values/styles.xml中定义无系统栏的Dialog主题：

<style name="NoSystemBarDialogTheme" parent="Theme.Material3.Dialog">
    <item name="android:windowFullscreen">true</item>
    <item name="android:windowTranslucentNavigation">true</item>
    <item name="android:windowDrawsSystemBarBackgrounds">false</item>
</style>

然后在导航的dialog块中指定该主题，并关闭系统栏适配：

dialog(
    route = Screen.SettingDialog.route,
    dialogProperties = DialogProperties(
        usePlatformDefaultWidth = false,
        decorFitsSystemWindows = false
    ),
    theme = R.style.NoSystemBarDialogTheme
) {
    SettingDialogScreen(
        onDismissRequest = { navController.popBackStack(route = Screen.Main.route, inclusive = false) },
        onSignOutButtonClickListener = { navController.navigate(Screen.Sign.route) },
        onSettingScreenButtonClickListener = {
            navController.popBackStack()
            navController.navigate(Screen.Setting.route)
        },
    )
}

方案三：优化rememberSystemUiController的执行时机 #

若坚持使用rememberSystemUiController，可通过LaunchedEffect确保在Composable初始化时立即执行隐藏逻辑，减少延迟：

@Composable
fun SettingDialogScreen(...) {
    val systemUIController = rememberSystemUiController()
    
    LaunchedEffect(Unit) {
        systemUIController.isNavigationBarVisible = false
    }
    
    // 其余Dialog内容
}

总结 #

优先选择方案一或方案二，这两种方式直接在Dialog创建阶段配置Window属性，完全避免了Compose布局渲染带来的延迟，可彻底解决系统栏短暂显示的问题。

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