Typography Theming
Material Design typography theming can be used to create typographic styles that reflect your brand or style by defining a set of type scales which will be used throughout your app. Material components use these type scales to style their individual text appearance.
Design & API Documentation
Usage
Attribute name | Default style |
---|---|
textAppearanceHeadline1 | Light 96sp |
textAppearanceHeadline2 | Light 60sp |
textAppearanceHeadline3 | Regular 48sp |
textAppearanceHeadline4 | Regular 34sp |
textAppearanceHeadline5 | Regular 24sp |
textAppearanceHeadline6 | Medium 20sp |
textAppearanceSubtitle1 | Regular 16sp |
textAppearanceSubtitle2 | Medium 14sp |
textAppearanceBody1 | Regular 16sp |
textAppearanceBody2 | Regular 14sp |
textAppearanceCaption | Regular 12sp |
textAppearanceButton | Medium all caps 14sp |
textAppearanceOverline | Regular all caps 10sp |
Style values
Style values are a combination of the following:
- Font face name and weight
- Font size
- Letter spacing
- Text transformation (e.g., all caps)
Customization
The components included in the Material Design Library reference these themeable text attributes, enabling you to easily change text appearance across your whole application. If you display text in TextViews or create custom components, consider referencing one of these text attributes where it makes sense.
You can change the look of any text style by creating a new style and setting it in your theme:
<style name="TextAppearance.MyApp.Headline1" parent="TextAppearance.MaterialComponents.Headline1">
...
<item name="fontFamily">@font/custom_font</item>
<item name="android:textStyle">normal</item>
<item name="android:textAllCaps">false</item>
<item name="android:textSize">64sp</item>
<item name="android:letterSpacing">0</item>
...
</style>
xxxxxxxxxx
<style name="Theme.MyApp" parent="Theme.MaterialComponents.Light">
...
<item name="textAppearanceHeadline1">@style/TextAppearance.MyApp.Headline1</item>
...
</style>
Note: AppCompat must be used to handle backwards compatibility for sdk < 16. If you don't need to support devices < 16 and aren't using AppCompat, you should set android:fontFamily instead of fontFamily or app:fontFamily.
Downloadable Fonts
Android O and Android Support Library 26 add support for
Note: If you want to use a Downloadable Font before Android O, make sure you are using AppCompatTextView or that you are loading the font yourself with ResourcesCompat.getFont().