Fournit des instructions de rendu pour un élément textuel spécifique.
Introduit dans Wear OS 4.
Syntaxe
<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>
Attributs
L'élément Font
comporte les attributs suivants. Certains attributs sont obligatoires, alors que d'autres sont facultatifs.
Attributs obligatoires
Les attributs suivants sont obligatoires :
family
Nom de la police utilisée pour le rendu du texte. Utiliser la même police en tant que système, définissez cette valeur sur
SYNC_TO_DEVICE
.Pour utiliser une police personnalisée, placez le fichier de police dans
res/font/
, en utilisant l'une des Extensions de fichier de police acceptées suivantes: TTF, OTF, TTC ou XML. Ensuite, définissez ce au nom du fichier de police, en excluant l'extension à la fin.Si le fichier de police ne peut pas être résolu, la police système est utilisée.
size
Valeur à virgule flottante spécifiant la taille du texte.
Attributs facultatifs
Les attributs suivants sont facultatifs :
color
- Couleur du texte. Si vous spécifiez une couleur, vous devez utiliser le format ARVB (
#ff000000
= noir opaque) ou RVB (#000000
= noir). letterSpacing
- Espace entre les lettres, spécifié en unités EM. La valeur par défaut est 0. Exemple d'expansion légère : 0,05. Les valeurs négatives resserrent le texte.
slant
- Utilisez l'inclinaison de la police
NORMAL
(par défaut) ouITALIC
. width
Énumération de plusieurs possibilités qu'une variante de famille de polices doit utiliser. La valeur par défaut est
NORMAL
, ce qui applique la variante "normal" de la police.La liste suivante contient les autres valeurs d'énumération et les variantes de famille de polices correspondantes qu'elles utilisent, si cette variante est disponible pour la police :
ULTRA_CONDENSED
etEXTRA_CONDENSED
utilisent la variante "condensed-light".CONDENSED
utilise la variante "condensed".SEMI_CONDENSED
utilise la variante "condensed-medium".SEMI_EXPANDED
,EXPANDED
,EXTRA_EXPANDED
etULTRA_EXPANDED
utilisent chacun la variante "normal".
weight
Énumération de plusieurs épaisseurs de police possibles. La valeur par défaut est
NORMAL
, ce qui applique une pondération de400
.La liste suivante contient les autres valeurs d'énumération et leur pondération de police respective :
THIN
utilise une épaisseur de police de100
.ULTRA_LIGHT
utilise une épaisseur de police de150
.EXTRA_LIGHT
utilise une épaisseur de police de200
.LIGHT
utilise une épaisseur de police de300
.MEDIUM
utilise une épaisseur de police de500
.SEMI_BOLD
utilise une épaisseur de police de600
.ULTRA_BOLD
utilise une épaisseur de police de750
.EXTRA_BOLD
utilise une épaisseur de police de800
.BLACK
utilise une épaisseur de police de900
.EXTRA_BLACK
utilise une épaisseur de police de1000
.
Éléments internes
L'élément Font
peut contenir les éléments internes suivants :