Comprehensive Guide to Android Font Families: Valid android:fontFamily Values and Their Mappings

Overview of Android Font System

In Android application development, font configuration is a crucial aspect of interface design. The android:fontFamily attribute is used to specify the font family for text views, but its valid values are not completely listed in the standard API documentation. By analyzing Android source code and official release notes, we can understand the specific meanings and mappings of these values.

Source of Font Family Values

The valid values for android:fontFamily primarily originate from Android system's internal configuration. Although the official API documentation does not explicitly list all options, the Android 4.1 (Jelly Bean) release notes clearly mention the newly added font families. These values correspond to system-preinstalled Roboto font variants, mapped through specific naming conventions.

Font Families Added in Android 4.1

Android 4.1 introduced several new font family values:

android:fontFamily="sans-serif"           // Roboto regular
android:fontFamily="sans-serif-light"     // Roboto light
android:fontFamily="sans-serif-condensed" // Roboto condensed

Combining Font Variants

By combining android:fontFamily and android:textStyle attributes, developers can achieve multiple font variants. textStyle supports three basic styles: normal, bold, and italic, which can be combined using the pipe symbol.

12 Font Variant Configuration Examples

Below are complete configuration examples for all 12 font variants:

Regular Font Variants

<item name="android:fontFamily">sans-serif</item>
<item name="android:textStyle">normal</item>

<item name="android:fontFamily">sans-serif</item>
<item name="android:textStyle">italic</item>

<item name="android:fontFamily">sans-serif</item>
<item name="android:textStyle">bold</item>

<item name="android:fontFamily">sans-serif</item>
<item name="android:textStyle">bold|italic</item>

Light Font Variants

<item name="android:fontFamily">sans-serif-light</item>
<item name="android:textStyle">normal</item>

<item name="android:fontFamily">sans-serif-light</item>
<item name="android:textStyle">italic</item>

Condensed Font Variants

<item name="android:fontFamily">sans-serif-condensed</item>
<item name="android:textStyle">normal</item>

<item name="android:fontFamily">sans-serif-condensed</item>
<item name="android:textStyle">italic</item>

<item name="android:fontFamily">sans-serif-condensed</item>
<item name="android:textStyle">bold</item>

<item name="android:fontFamily">sans-serif-condensed</item>
<item name="android:textStyle">bold|italic</item>

Extensions in Android 4.2 and 5.0

In subsequent versions, Android continued to expand font family support:

Added in Android 4.2

android:fontFamily="sans-serif-thin"      // Roboto thin

Added in Android 5.0

android:fontFamily="sans-serif-medium"    // Roboto medium
android:fontFamily="sans-serif-black"     // Roboto black

Common Usage Mistakes

In practical development, a common mistake is directly referencing font file paths:

<item name="android:fontFamily">Roboto-Regular.ttf</item>

This usage is incorrect; instead, use system-defined font family names:

<item name="android:fontFamily">sans-serif</item>

Best Practice Recommendations

To ensure correct and consistent font configuration in applications, it is recommended to:

1. Use system-defined font family names instead of directly referencing font files
2. Properly combine fontFamily and textStyle attributes to achieve desired font effects
3. Consider compatibility across different Android versions and provide appropriate fallback solutions
4. Define font styles uniformly in application themes to avoid code duplication

Conclusion

Android's font system provides rich font variant support through the combination of fontFamily and textStyle attributes. Understanding the correct usage of these attributes is essential for creating consistent and aesthetically pleasing user interfaces. By following the configuration examples and best practices provided in this article, developers can effectively manage and optimize font settings in their applications.