BottomSheetDialog背景未变暗，顶部区域显示白色的问题求助

核心问题原因 #

问题本质是App主题未正确继承MaterialComponents主题，或自定义样式配置错误，导致BottomSheetDialog默认的背景暗化、圆角特性失效。

分步解决方案 #

1. 确认App主题继承自MaterialComponents #

打开res/values/styles.xml，确保App基础主题继承自Theme.MaterialComponents.xxx系列，而非Theme.AppCompat.xxx：

<style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <!-- 其他主题属性配置 -->
</style>

这是BottomSheetDialog默认效果生效的前提，圆角、背景暗化都是Material组件的原生特性，依赖Material主题支持。

2. 修复自定义样式配置 #

修正自定义样式的错误属性放置，补充透明与暗化相关设置：

<!-- BottomSheetDialog 容器样式 -->
<style name="CustomBottomSheetDialog" parent="Theme.MaterialComponents.BottomSheetDialog">
    <item name="bottomSheetStyle">@style/CustomBottomSheet</item>
    <!-- 窗口背景设为透明，启用背景暗化 -->
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:backgroundDimEnabled">true</item>
    <item name="android:backgroundDimAmount">0.5</item> <!-- 暗度值0-1，可按需调整 -->
    <!-- 软键盘适配移至此处，原放在shape样式中属于错误配置 -->
    <item name="android:windowSoftInputMode">adjustResize</item>
</style>

<!-- BottomSheet 内容容器样式 -->
<style name="CustomBottomSheet" parent="Widget.MaterialComponents.BottomSheet">
    <item name="shapeAppearanceOverlay">@style/CustomShapeAppearanceBottomSheetDialog</item>
    <!-- 容器背景设为透明，让内容布局的背景正常显示 -->
    <item name="android:background">@android:color/transparent</item>
</style>

<!-- 圆角样式配置 -->
<style name="CustomShapeAppearanceBottomSheetDialog" parent="">
    <item name="cornerFamily">rounded</item>
    <item name="cornerSizeTopLeft">16dp</item>
    <item name="cornerSizeTopRight">16dp</item>
    <item name="cornerSizeBottomLeft">0dp</item>
    <item name="cornerSizeBottomRight">0dp</item>
</style>

3. 调整内容布局背景 #

给BottomSheet的内容根布局添加白色背景，避免透明穿透导致视觉异常：

<androidx.constraintlayout.widget.ConstraintLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/bSheet"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@android:color/white" <!-- 添加此行 -->
    android:paddingHorizontal="@dimen/core_padding_16"
    android:paddingTop="@dimen/core_vertical_margin_16"
    android:paddingBottom="@dimen/core_vertical_margin">
    
    <!-- 原有内容组件 -->
</androidx.constraintlayout.widget.ConstraintLayout>

4. 代码层面兜底处理（可选） #

若上述配置仍未生效，可在创建Dialog时手动设置窗口属性：

notificationsBottomSheetDialog = BottomSheetDialog(requireContext(), R.style.CustomBottomSheetDialog)
// 手动配置窗口暗化与透明
notificationsBottomSheetDialog.window?.apply {
    setDimAmount(0.5f)
    setBackgroundDrawable(ColorDrawable(Color.TRANSPARENT))
}
notificationsBottomSheetDialog.setCanceledOnTouchOutside(false)
notificationsBottomSheetDialog.setContentView(notificationsBottomSheetBinding.root)

无自定义样式时的问题解决 #

如果不使用自定义样式仍无圆角、背景未变暗，直接检查App主题是否为MaterialComponents主题，这是此类问题最常见的触发原因。

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