入门必看

使用材料主题

See 使用材料主题

如果要在 Android 5.0 之前的 Android 版本中使用材料主题,请参考 保持兼容性

材料主题的定义为:

  • @android:style/Theme.Material(深色版本)
  • @android:style/Theme.Material.Light(浅色版本)
  • @android:style/Theme.Material.Light.DarkActionBar

如果要了解您可使用的材料风格,请参阅 [R.style](https://developer.android.com/reference/android/R.style.html) 的 API 参考。

如果要在您的应用中使用材料主题,请指定一个从
android:Theme.Material 继承的风格:

1
2
3
4
5
6
7
<!-- res/values/styles.xml -->
<resources>
<!-- your theme inherits from the material theme -->
<style name="AppTheme" parent="android:Theme.Material">
<!-- theme customizations -->
</style>
</resources>

材料主题提供更新的系统小组件,让您能够为触摸反馈以及操作行为转换设置配色工具以及默认动画。

定制配色工具

如果要定制主题的基色以符合您的品牌,您可在进行材料主题继承时使用主题属性定义您的定制颜色:

1
2
3
4
5
6
7
8
9
10
11
12
<resources>
<!-- inherit from the material theme -->
<style name="AppTheme" parent="android:Theme.Material">
<!-- Main theme colors -->
<!-- your app branding color for the app bar -->
<item name="android:colorPrimary">@color/primary</item>
<!-- darker variant for the status bar and contextual app bars -->
<item name="android:colorPrimaryDark">@color/primary_dark</item>
<!-- theme UI controls like checkboxes and text fields -->
<item name="android:colorAccent">@color/accent</item>
</style>
</resources>

定制状态栏

如果要为状态栏设置定制颜色,您可在扩展材料主题时使用 android:statusBarColor 属性。

默认情况下,android:statusBarColor 将继承 android:colorPrimaryDark 的值。

可以将 android:statusBarColor 属性设置为 @android:color/transparent 并根据需要调整窗口标志,以使用背景来作为状态栏的背景。

您也可以使用 Window.setStatusBarColor())方法进行动画或淡出设置。

Material Components

Resource