Fuente

Proporciona instrucciones de renderización para un elemento de texto específico.

Se introdujo en Wear OS 4.

Sintaxis

<Font family="string | SYNC_TO_DEVICE" size="float"
      color="argb-color | rgb-color" slant="NORMAL | ITALIC"
      letterSpacing="em-value"
      width="ULTRA_CONDENSED | EXTRA_CONDENSED | CONDENSED | SEMI_CONDENSED |
             NORMAL | SEMI_EXPANDED | EXPANDED | EXTRA_EXPANDED |
             ULTRA_EXPANDED"
      weight="THIN | ULTRA_LIGHT | EXTRA_LIGHT | LIGHT | NORMAL | MEDIUM |
              BOLD | SEMI_BOLD | ULTRA_BOLD | EXTRA_BOLD | BLACK | EXTRA_BLACK">
    <!-- Inner elements consist of text decoration and text formatting
         options. Here, "Lower" is used as an example. -->
    <Lower ... />
</Font>

Atributos

El elemento Font tiene los siguientes atributos. Algunos son obligatorios, y otros opcionales.

Atributos obligatorios

Se requieren los siguientes atributos:

family

Es el nombre de la fuente que se usa para renderizar el texto. Para usar la misma familia de fuentes que el sistema, establece este valor en SYNC_TO_DEVICE.

Para usar una fuente personalizada, coloca el archivo de fuente en res/fonts/ con una de las siguientes extensiones de archivo de fuente aceptadas: TTF, OTF, TTC o XML. Luego, establece este valor como el nombre del archivo de fuente y excluye la extensión al final.

Si no se puede resolver el archivo de fuente, se utiliza la fuente del sistema.

size

Es un valor de punto flotante que especifica el tamaño del texto.

Atributos opcionales

Los siguientes atributos son opcionales:

color
Es el color del texto. Si se proporciona, debes especificar el color con los formatos ARGB (#ff000000 = negro opaco) o RGB (#000000 = negro).
letterSpacing
Es el espacio entre letras, especificado en unidades EM. El valor predeterminado es 0. Un ejemplo de una leve expansión podría ser 0.05. Los valores negativos refuerzan el texto.
slant
Indica si se usa una inclinación de la fuente NORMAL (predeterminada) o ITALIC.
width

Es una enumeración de varias sugerencias que puede usar una variante de la familia de fuentes. El valor predeterminado es NORMAL, que aplica la variante "normal" de la fuente.

La siguiente lista contiene los otros valores de enumeración y las respectivas variantes de la familia de fuentes que usan, si esa variante está disponible para la fuente:

  • ULTRA_CONDENSED y EXTRA_CONDENSED usan la variante "condensed-light".
  • CONDENSED usa la variante "condensed".
  • SEMI_CONDENSED usa la variante "condensed-medium".
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED y ULTRA_EXPANDED usan la variante "normal".
weight

Es una enumeración de varios grosores de fuente posibles. El valor predeterminado es NORMAL, que aplica un grosor de 400.

La siguiente lista contiene los otros valores de enumeración y sus respectivos grosores de fuente:

  • THIN usa un grosor de fuente de 100.
  • ULTRA_LIGHT usa un grosor de fuente de 150.
  • EXTRA_LIGHT usa un grosor de fuente de 200.
  • LIGHT usa un grosor de fuente de 300.
  • MEDIUM usa un grosor de fuente de 500.
  • SEMI_BOLD usa un grosor de fuente de 600.
  • ULTRA_BOLD usa un grosor de fuente de 750.
  • EXTRA_BOLD usa un grosor de fuente de 800.
  • BLACK usa un grosor de fuente de 900.
  • EXTRA_BLACK usa un grosor de fuente de 1000.

Elementos internos

El elemento Font puede contener los siguientes elementos internos: