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 fuente como sistema, establece este valor en
SYNC_TO_DEVICE
.Para usar una fuente personalizada, coloca el archivo de fuente en
res/font/
mediante uno de los las siguientes extensiones de archivo de fuentes aceptadas: TTF, OTF, TTC o XML. Luego, establece esta al nombre del archivo de fuente, sin incluir la extensión al final.Si no se puede resolver el archivo de fuente, se usa 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 las letras, que se especifica en unidades EM. El valor predeterminado es 0. Un ejemplo de una leve expansión podría ser 0.05. Los valores negativos ajustan el texto.
slant
- Indica si se usa una inclinación de la fuente
NORMAL
(predeterminada) oITALIC
. 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
yEXTRA_CONDENSED
usan la variante "condensed-light".CONDENSED
usa la variante "condensed".SEMI_CONDENSED
usa la variante "condensed-medium".SEMI_EXPANDED
,EXPANDED
,EXTRA_EXPANDED
yULTRA_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 de400
.La siguiente lista contiene los otros valores de enumeración y sus respectivos grosores de fuente:
THIN
usa un grosor de fuente de100
.ULTRA_LIGHT
usa un grosor de fuente de150
.EXTRA_LIGHT
usa un grosor de fuente de200
.LIGHT
usa un grosor de fuente de300
.MEDIUM
usa un grosor de fuente de500
.SEMI_BOLD
usa un grosor de fuente de600
.ULTRA_BOLD
usa un grosor de fuente de750
.EXTRA_BOLD
usa un grosor de fuente de800
.BLACK
usa un grosor de fuente de900
.EXTRA_BLACK
usa un grosor de fuente de1000
.
Elementos internos
El elemento Font
puede contener los siguientes elementos internos: