Police

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. Pour utiliser la même famille de polices que le système, définissez cette valeur sur SYNC_TO_DEVICE.

Pour utiliser une police personnalisée, placez le fichier de police dans res/fonts/ en utilisant l'une des extensions de fichier de police acceptées suivantes: TTF, OTF, TTC ou XML. Définissez ensuite cette valeur sur le 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. Par exemple, pour une légère expansion, vous pouvez obtenir 0,05. Les valeurs négatives renforcent le texte.
slant
Utilisez l'inclinaison de la police NORMAL (par défaut) ou ITALIC.
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 et EXTRA_CONDENSED utilisent la variante "condensed-light".
  • CONDENSED utilise la variante "condensed".
  • SEMI_CONDENSED utilise la variante "condensed-medium".
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED et ULTRA_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 de 400.

La liste suivante contient les autres valeurs d'énumération et leur pondération de police respective :

  • THIN utilise une épaisseur de police de 100.
  • ULTRA_LIGHT utilise une épaisseur de police de 150.
  • EXTRA_LIGHT utilise une épaisseur de police de 200.
  • LIGHT utilise une épaisseur de police de 300.
  • MEDIUM utilise une épaisseur de police de 500.
  • SEMI_BOLD utilise une épaisseur de police de 600.
  • ULTRA_BOLD utilise une épaisseur de police de 750.
  • EXTRA_BOLD utilise une épaisseur de police de 800.
  • BLACK utilise une épaisseur de police de 900.
  • EXTRA_BLACK utilise une épaisseur de police de 1000.

Éléments internes

L'élément Font peut contenir les éléments internes suivants :