为什么我的BottomSheetDialogFragment会忽略应用的自定义主题配置？

问题产生原因 #

• BottomSheetDialogFragment默认使用独立的浅色主题实例化弹窗，不会自动继承应用全局的深色主题配置，是该组件的默认设计。
• 现有代码仅自定义了弹窗内部的布局，没有修改弹窗本身的主题属性，底层BottomSheet容器的背景、强调色都沿用默认主题的配置，所以和应用主题不一致。
• 如果应用使用的主题未继承MaterialComponents相关主题，也会出现属性不匹配的异常。

修复方案 #

方案1：全局配置（最优，一次修改所有BottomSheet生效） #

在应用的themes.xml（或styles.xml）的全局主题节点下添加属性，指定全局的BottomSheet弹窗主题：

<!-- 应用全局主题 -->
<style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <!-- 其他原有配置 -->
    <item name="bottomSheetDialogTheme">@style/AppBottomSheetDialogTheme</item>
</style>

<!-- 自定义BottomSheet主题 -->
<style name="AppBottomSheetDialogTheme" parent="Theme.MaterialComponents.DayNight.BottomSheetDialog">
    <item name="android:colorBackground">?attr/colorSurface</item>
    <item name="colorPrimary">?attr/colorPrimary</item>
    <item name="colorSecondary">?attr/colorSecondary</item>
    <!-- 可自定义圆角、拖拽条等属性 -->
    <item name="bottomSheetCornerRadius">16dp</item>
</style>

如果应用是固定深色主题，可将主题parent替换为Theme.MaterialComponents.Dark.BottomSheetDialog。

方案2：单独为当前CustomBottomDialogFragment指定主题 #

在现有CustomBottomDialogFragment类中重写onCreateDialog方法，创建弹窗时指定自定义主题：

@NonNull
@Override
public Dialog onCreateDialog(@Nullable Bundle savedInstanceState) {
    return new BottomSheetDialog(requireContext(), R.style.AppBottomSheetDialogTheme);
}

主题定义和方案1一致即可，该方法只会修改当前Fragment的弹窗主题，不会影响其他地方的BottomSheet。

方案3：动态修改容器属性（应急用，不推荐长期使用） #

如果不想修改主题配置，可以在Fragment的onStart生命周期中动态修改BottomSheet容器的背景色：

@Override
public void onStart() {
    super.onStart();
    BottomSheetDialog dialog = (BottomSheetDialog) getDialog();
    if (dialog == null) return;
    View bottomSheet = dialog.findViewById(com.google.android.material.R.id.design_bottom_sheet);
    if (bottomSheet != null) {
        bottomSheet.setBackgroundColor(ContextCompat.getColor(requireContext(), R.color.your_dark_bg_color));
    }
}

该方法仅能修改背景色，强调色等其他属性仍需通过主题适配。

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