Android CalendarDatePicker头部背景样式不生效，如何配置正确item属性？

问题原因 #

MDC MaterialCalendar 组件的头部背景优先级高于 HeaderLayout 中配置的 android:background，默认读取主题层面的专属配色属性，所以你现有配置不生效。

解决方法 #

按优先级依次尝试以下方案即可： #

方案1（推荐，无需修改HeaderLayout样式）

直接在你的 Widget.Foo.CalendarDatePickerDialog 样式中添加 materialCalendarHeader 配色配置，修改后样式如下：

<style name="Widget.Foo.CalendarDatePickerDialog" parent="@style/ThemeOverlay.MaterialComponents.MaterialCalendar">
    <!-- 原有配置保持不变 -->
    <item name="buttonBarPositiveButtonStyle">@style/Buttons</item>
    <item name="buttonBarNegativeButtonStyle">@style/Buttons</item>
    <item name="android:textColorPrimary">@color/white</item>
    <item name="materialCalendarHeaderLayout">@style/CustomHeaderLayout</item>
    <item name="colorPrimary">@color/android_purple</item>
    <item name="colorAccent">@color/android_purple</item>
    <item name="colorSurface">@color/black</item>
    <!-- 新增这一行即可 -->
    <item name="materialCalendarHeader">@color/android_purple</item>
</style>

方案2（适配低版本MDC组件）

如果方案1未生效，是因为你使用的MDC版本低于1.5.0，需要修改你的 CustomHeaderLayout 样式，关闭默认背景着色：

<style name="CustomHeaderLayout" parent="Widget.MaterialComponents.MaterialCalendar.HeaderLayout">
    <item name="android:background">@color/android_purple</item>
    <!-- 新增这行清除默认背景tint -->
    <item name="backgroundTint">@null</item>
</style>

排查验证

如果以上两种方案都未生效，确认你实例化日期选择器时，明确指定了自定义的主题：

// Kotlin 示例代码
val datePicker = MaterialDatePicker.Builder.datePicker()
    .setTheme(R.style.Widget_Foo_CalendarDatePickerDialog)
    .build()
datePicker.show(supportFragmentManager, "DATE_PICKER")

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