Android全屏DialogFragment透明状态栏下如何修改状态栏文字颜色（保留遮罩）

需求明确 #

• 状态栏设置为完全透明
• 浅色主题下状态栏文字显示为深色，深色主题下显示为白色
• 保留Dialog的窗口遮罩效果（禁止清除FLAG_DIM_BEHIND）

解决方案 #

1. 修改Dialog主题样式（MyDialogStyle1）

在res/values/styles.xml及res/values-night/styles.xml中配置主题，确保遮罩保留且窗口能延伸至状态栏：

<!-- 通用配置 -->
<style name="MyDialogStyle1" parent="Theme.AppCompat.Light.Dialog.Alert">
    <item name="android:windowBackground">@android:color/transparent</item>
    <!-- 必须设置为false，让Dialog窗口占满屏幕高度（包括状态栏） -->
    <item name="android:windowIsFloating">false</item>
    <item name="android:windowNoTitle">true</item>
    <!-- 保留遮罩并设置透明度（0-1，数值越大遮罩越暗） -->
    <item name="android:backgroundDimEnabled">true</item>
    <item name="android:backgroundDimAmount">0.5</item>
</style>

2. 修改DialogFragment代码，配置状态栏

在onStart方法中添加状态栏相关配置（窗口初始化完成后操作更可靠）：

@Override
public void onStart() {
    super.onStart();
    Dialog dialog = getDialog();
    if (dialog != null) {
        Window window = dialog.getWindow();
        if (window != null) {
            // 保持原有布局设置
            int width = window.getAttributes().width;
            window.setLayout(width, ViewGroup.LayoutParams.MATCH_PARENT);

            // 状态栏透明核心配置
            window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
            window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
            window.setStatusBarColor(Color.TRANSPARENT);

            // 根据主题自动适配状态栏文字颜色
            int uiMode = getResources().getConfiguration().uiMode;
            boolean isLightTheme = (uiMode & Configuration.UI_MODE_NIGHT_MASK) == Configuration.UI_MODE_NIGHT_NO;
            if (isLightTheme) {
                // 浅色主题：状态栏文字设为深色
                window.getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
            } else {
                // 深色主题：恢复白色文字
                window.getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_VISIBLE);
            }
        }
    }
}

关键说明 #

• 遮罩保留：通过主题的backgroundDimEnabled和backgroundDimAmount实现，无需清除FLAG_DIM_BEHIND
• 状态栏延伸：必须设置windowIsFloating="false"，否则Dialog窗口无法覆盖状态栏区域，透明效果失效
• 文字颜色适配：通过系统UI模式判断当前主题，动态设置状态栏文字颜色，符合系统规范

效果展示 #

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