Skip to content

Latest commit

 

History

History
94 lines (76 loc) · 3.24 KB

Typography.md

File metadata and controls

94 lines (76 loc) · 3.24 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. You can use type scales to customize the appearance of text in Material components.

Design & API documentation

Usage

Attribute name Default style
textAppearanceDisplayLarge Regular 57sp
textAppearanceDisplayMedium Regular 45sp
textAppearanceDisplaySmall Regular 36sp
textAppearanceHeadlineLarge Regular 32sp
textAppearanceHeadlineMedium Regular 28sp
textAppearanceHeadlineSmall Regular 24sp
textAppearanceTitleLarge Regular 22sp
textAppearanceTitleMedium Medium 16sp
textAppearanceTitleSmall Medium 14sp
textAppearanceBodyLarge Regular 16sp
textAppearanceBodyMedium Regular 14sp
textAppearanceBodySmall Regular 12sp
textAppearanceLabelLarge Medium 14sp
textAppearanceLabelMedium Medium 12sp
textAppearanceLabelSmall Medium 11sp

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.DisplaySmall" parent="TextAppearance.Material3.DisplaySmall">
  ...
  <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.Material3.DayNight.NoActionBar">
  ...
  <item name="textAppearanceDisplaySmall">@style/TextAppearance.MyApp.DisplaySmall</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().