Cómo agregar una fuente como recurso XML

Android 8.0 (API nivel 26) presenta fuentes en XML, una función que te permite usar fuentes como recursos. Puedes agregar el archivo font en la carpeta res/font/ para agrupar las fuentes como recursos. Estas fuentes se compilan en tu archivo R y están disponibles automáticamente en Android Studio. Puedes acceder a los recursos de fuente mediante el tipo de recurso font. Por ejemplo, para acceder a un recurso de fuente, usa @font/myfont o R.font.myfont.

Para usar las fuentes en la función XML en dispositivos con Android 4.1 (API nivel 16) y versiones posteriores, usa la biblioteca de compatibilidad 26.0. Para obtener más información sobre su uso, consulta la sección Cómo usar la biblioteca de compatibilidad.

Para agregar fuentes como recursos, sigue estos pasos en Android Studio:

  1. Haz clic con el botón derecho en la carpeta res y ve a New > Android resource directory. Aparecerá la ventana New Resource Directory.
  2. En la lista Resource type, selecciona font y, luego, haz clic en OK.

    Nota: El nombre del directorio de recursos debe ser font.

    Adición del directorio de recursos de fuentes

    Figura 1: Cómo agregar el directorio de recursos de fuentes

  3. Agrega los archivos de fuentes en la carpeta font.

    La estructura de carpetas a continuación genera R.font.dancing_script, R.font.lobster y R.font.typo_graphica.

    Adición de los archivos de fuentes en el directorio de recursos

    Figura 2: Agregar los archivos de fuentes en el directorio res/font

  4. Haz doble clic en un archivo de fuente para obtener una vista previa de las fuentes del archivo en el editor. Vista previa del archivo de fuente

    Figura 3: Vista previa del archivo de fuentes

Cómo crear una familia de fuentes

Una familia de fuentes es un conjunto de archivos de fuentes junto con detalles de estilo y peso. En Android, puedes crear una nueva familia de fuentes como un recurso XML y acceder a ella como una sola unidad, en lugar de hacer referencia a cada estilo y peso como recursos separados. De esta manera, permites que el sistema seleccione la fuente correcta según el estilo de texto que usas.

Para crear una familia de fuentes, sigue estos pasos en Android Studio:

  1. Haz clic con el botón derecho en la carpeta font y selecciona New > Font resource file. Aparecerá la ventana New Resource File.
  2. Ingresa el nombre del archivo y haz clic en OK. Se abrirá en el editor, el nuevo XML de recursos de fuentes.
  3. Adjunta cada atributo de peso, estilo y archivo de fuente en el elemento <font>. En el siguiente XML, se muestra cómo se agregan los atributos relacionados con fuentes en el XML de recursos de fuentes:
    <?xml version="1.0" encoding="utf-8"?>
    <font-family xmlns:android="http://schemas.android.com/apk/res/android">
        <font
            android:fontStyle="normal"
            android:fontWeight="400"
            android:font="@font/lobster_regular" />
        <font
            android:fontStyle="italic"
            android:fontWeight="400"
            android:font="@font/lobster_italic" />
    </font-family>
    

Cómo usar fuentes en diseños XML

Usa tus fuentes, ya sea un archivo de fuente único o una familia de fuentes, en objetos TextView o en estilos con el atributo fontFamily.

Nota: Cuando usas una familia de fuentes, TextView cambia por sí solo, según sea necesario, para usar los archivos de fuentes de esa familia.

Cómo agregar fuentes a una TextView

A fin de configurar una fuente para TextView, realiza una de las siguientes acciones:

  • En el archivo en formato XML de diseño, configura el atributo fontFamily en el archivo de fuente al que deseas acceder.
    <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:fontFamily="@font/lobster"/>
    
  • Abre la ventana Properties para configurar la fuente correspondiente al objeto TextView.
    1. Selecciona una vista para abrir la ventana Properties.

      Nota: La ventana Properties solo está disponible cuando el editor de diseño está abierto. Selecciona la pestaña Design en la parte inferior de la ventana.

    2. Expande la propiedad textAppearance y selecciona la fuente de la lista fontFamily.
    3. Selección de la fuente desde Properties

      Figura 4: Selección de la fuente desde la ventana Properties.

La vista previa del diseño de Android Studio, que se muestra en el panel de la derecha en la Figura 5, te permite obtener una vista previa del conjunto de fuentes en TextView.

Previsualización de las fuentes en la vista previa del diseño

Figura 5: Vista previa de las fuentes en la vista previa de diseño

Cómo agregar fuentes a un estilo

Abre el archivo styles.xml y configura el atributo fontFamily en el archivo de fuente al que deseas acceder.

  • <style name="customfontstyle" parent="@android:style/TextAppearance.Small">
        <item name="android:fontFamily">@font/lobster</item>
    </style>
    
  • Cómo usar fuentes de manera programática

    Para recuperar fuentes de manera programática, llama al método getFont(int) y proporciona el identificador de recursos de la fuente que deseas recuperar. Este método muestra un objeto Typeface. Aunque el sistema elige el mejor estilo para ti a partir de la información de las fuentes, puedes usar el método setTypeface(android.graphics.Typeface, int) para configurar el tipo de letra con estilos específicos.

    Nota: TextView hace esto por ti.

    Kotlin

    val typeface = resources.getFont(R.font.myfont)
    textView.typeface = typeface
    

    Java

    Typeface typeface = getResources().getFont(R.font.myfont);
    textView.setTypeface(typeface);
    

    Usar la Biblioteca de soporte

    La biblioteca de compatibilidad 26.0 admite fuentes en XML en dispositivos con Android 4.1 (nivel de API 16) y versiones posteriores.

    Nota: Cuando declares las familias de fuentes en diseño XML mediante la biblioteca de compatibilidad, usa el espacio de nombres app para asegurarte de que se carguen.

    <?xml version="1.0" encoding="utf-8"?>
    <font-family xmlns:app="http://schemas.android.com/apk/res-auto">
        <font app:fontStyle="normal" app:fontWeight="400" app:font="@font/myfont-Regular"/>
        <font app:fontStyle="italic" app:fontWeight="400" app:font="@font/myfont-Italic" />
    </font-family>
    

    Para recuperar fuentes de manera programática, llama al método ResourceCompat.getFont(Context, int) y proporciona una instancia de Context y el identificador de recursos.

    Kotlin

    val typeface = ResourcesCompat.getFont(context, R.font.myfont)
    

    Java

    Typeface typeface = ResourcesCompat.getFont(context, R.font.myfont);