深色模式下如何为单个Fragment编程实现白色状态栏？

应用采用单Activity架构，使用Theme.MaterialComponents.Light.NoActionBar主题，需要在深色模式下仅为单个Fragment实现白色状态栏。尝试设置白色状态栏颜色及View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR标志后，仅标志生效（状态栏文字/图标变为深色），但状态栏背景被系统强制应用深色效果，设置的白色颜色未生效。

原代码：

var flags = it.decorView.systemUiVisibility or View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR
window.decorView.systemUiVisibility = flags

// 该颜色在日间/夜间资源中均为#F0F0F0
var statusBarColor = context.getColorCompat(R.color.white) 
window?.statusBarColor = statusBarColor

效果：状态栏文字为深色，但背景为系统强制的深色，而非设置的白色。

问题核心在于深色模式下Android Q（API 29）及以上系统会强制状态栏颜色与背景保持对比度，同时需确保没有冲突的UI标志影响颜色生效。以下是修正后的实现步骤：

1. 在Fragment中设置白色状态栏 #

在Fragment的onViewCreated或onResume方法中添加如下代码：

import android.os.Build
import android.view.View
import androidx.core.content.ContextCompat

// 获取Activity的Window实例
val window = requireActivity().window

// 清除可能存在的深色状态栏标志，避免冲突
window.decorView.systemUiVisibility = window.decorView.systemUiVisibility and View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR.inv()
// 设置浅色状态栏（文字、图标为深色，适配白色背景）
window.decorView.systemUiVisibility = window.decorView.systemUiVisibility or View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR

// 关闭系统强制的状态栏对比度适配（关键：解决深色模式下颜色被覆盖的问题）
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    window.isStatusBarContrastEnforced = false
}

// 设置状态栏为白色
window.statusBarColor = ContextCompat.getColor(requireContext(), R.color.white)

2. 恢复状态栏默认状态（避免影响其他Fragment） #

由于是单Activity架构，切换Fragment时需要恢复状态栏的默认设置，避免当前Fragment的状态栏配置影响其他页面。在Fragment的onDestroyView方法中添加恢复逻辑：

override fun onDestroyView() {
    super.onDestroyView()
    val window = requireActivity().window
    
    // 移除浅色状态栏标志，恢复默认文字颜色
    window.decorView.systemUiVisibility = window.decorView.systemUiVisibility and View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR.inv()
    
    // 恢复主题默认的状态栏颜色（可根据自身主题调整，比如用android.R.color.transparent或主题中定义的颜色）
    window.statusBarColor = ContextCompat.getColor(requireContext(), android.R.color.transparent)
    
    // 恢复系统强制对比度适配
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        window.isStatusBarContrastEnforced = true
    }
}

关键说明 #

• View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR仅在API 23及以上有效，若需兼容更低版本，可添加版本判断。
• isStatusBarContrastEnforced是Android Q新增的属性，用于控制系统是否强制状态栏颜色与背景的对比度，关闭后才能自定义深色模式下的状态栏颜色。

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