Skip to content

Latest commit

 

History

History
93 lines (75 loc) · 3.08 KB

Typography.md

File metadata and controls

93 lines (75 loc) · 3.08 KB
Raw

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>
<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 Downloadable Fonts. This allows you to easily use the entire Google Fonts Open Source collection without bundling a font with your apk. Find more information at https://developers.google.com/fonts/docs/android.

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().