Android中BottomSheetDialogFragment导航栏不生效问题优化咨询

不用重写onCreateDialog，只需要调整自定义主题的几个关键属性就能解决问题，核心是要同时配置导航栏颜色、浅色导航栏模式，以及BottomSheet的基础样式：

1. 定义自定义BottomSheetDialog主题 #

在res/values/styles.xml中添加以下样式（Material3和Material2项目分别对应不同父主题）：

Material3版本 #

<style name="CustomBottomSheetDialogTheme" parent="Theme.Material3.Light.BottomSheetDialog">
    <!-- 设置导航栏为白色 -->
    <item name="android:navigationBarColor">@android:color/white</item>
    <!-- 开启浅色导航栏模式，让系统导航图标变为深色，适配白色背景 -->
    <item name="android:windowLightNavigationBar">true</item>
    <!-- 配置BottomSheet的基础样式 -->
    <item name="bottomSheetStyle">@style/CustomBottomSheetStyle</item>
</style>

<style name="CustomBottomSheetStyle" parent="Widget.Material3.BottomSheet">
    <!-- 设置BottomSheet背景为白色，避免和导航栏视觉冲突 -->
    <item name="android:background">@android:color/white</item>
    <!-- 可选：调整BottomSheet的初始展开高度 -->
    <item name="behavior_peekHeight">480dp</item>
</style>

Material2版本 #

<style name="CustomBottomSheetDialogTheme" parent="Theme.Design.Light.BottomSheetDialog">
    <item name="android:navigationBarColor">@android:color/white</item>
    <item name="android:windowLightNavigationBar">true</item>
    <item name="bottomSheetStyle">@style/CustomBottomSheetStyle</item>
</style>

<style name="CustomBottomSheetStyle" parent="Widget.Design.BottomSheet">
    <item name="android:background">@android:color/white</item>
</style>

2. 在BottomSheetDialogFragment中指定主题 #

只需要重写getTheme()返回上述自定义主题即可，无需其他额外代码：

class YourBottomSheetFragment : BottomSheetDialogFragment() {
    override fun getTheme(): Int {
        return R.style.CustomBottomSheetDialogTheme
    }

    // 你的Fragment逻辑代码...
}

为什么之前的设置无效？ #

• 仅设置android:navigationBarColor不够：默认情况下，BottomSheetDialog的窗口可能带有半透明导航栏标记，导致颜色设置不生效；同时如果未开启windowLightNavigationBar，白色导航栏上的系统图标也是白色，视觉上看起来和未设置一样（也就是你看到的左侧错误样式）。
• 调整bottomSheetStyle是为了确保BottomSheet背景和导航栏统一，避免视觉割裂，同时让BottomSheet布局行为正确，不会延伸覆盖导航栏。

兼容性说明 #

这个方案完全基于系统和Material库的标准样式属性，android:windowLightNavigationBar从API 26开始支持，android:navigationBarColor从API 21开始支持，Android R（API 30）及以上版本完全兼容，没有使用任何废弃API，不用担心崩溃问题。

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