Czcionka

zawiera instrukcje renderowania konkretnego elementu tekstowego;

Wprowadzone w Wear OS 4.

Składnia

<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>

Atrybuty

Element Font ma te atrybuty: Niektóre atrybuty są wymagane, a inne opcjonalne.

Atrybuty wymagane

Wymagane są te atrybuty:

family

Nazwa czcionki użytej do renderowania tekstu. Aby użyć tej samej rodziny czcionek co system, ustaw tę wartość na SYNC_TO_DEVICE.

Aby użyć czcionki niestandardowej, umieść plik czcionki w folderze res/font/, używając jednego z tych rozszerzeń: TTF, OTF, TTC lub XML. Następnie ustaw tę wartość jako nazwę pliku czcionki, bez rozszerzenia na końcu.

Jeśli nie można zlokalizować pliku czcionki, używana jest czcionka systemowa.

size

Wartość zmiennoprzecinkowa określająca rozmiar tekstu.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

color
Kolor tekstu. Jeśli kolor jest podany, musisz go określić w formacie ARGB (#ff000000 = czarny przezroczysty) lub RGB (#000000 = czarny).
letterSpacing
Odstęp między literami określony w jednostkach EM. Wartością domyślną jest 0. Przykładem lekkiej ekspansji może być wartość 0,05. Wartości ujemne powodują zawężenie tekstu.
slant
Czy użyć czcionki NORMAL (domyślnie) czy ITALIC.
width

Wyliczenie kilku wskazówek dotyczących wariantu rodziny czcionek do użycia. Wartością domyślną jest NORMAL, co oznacza zastosowanie zwykłego wariantu czcionki.

Poniższa lista zawiera inne wartości enumeracji i odpowiednie warianty rodziny czcionek, których używają, jeśli są one dostępne dla czcionki:

  • ULTRA_CONDENSED i EXTRA_CONDENSED używają wariantu „skompresowany-lekki”.
  • CONDENSED używa wariantu „skrócony”.
  • SEMI_CONDENSED używa odmiany „skompresowana – średnia”.
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED i ULTRA_EXPANDED używają wariantu „normalny”.
weight

Wyliczenie kilku możliwych grubości czcionki. Wartością domyślną jest NORMAL, co oznacza zastosowanie wagi 400.

Poniższa lista zawiera inne wartości enumeracji i odpowiednie wartości wagi czcionki:

  • THIN używa czcionki o grubości 100.
  • ULTRA_LIGHT używa czcionki o grubości 150.
  • EXTRA_LIGHT używa czcionki o grubości 200.
  • LIGHT używa czcionki o grubości 300.
  • MEDIUM używa czcionki o grubości 500.
  • SEMI_BOLD używa czcionki o grubości 600.
  • ULTRA_BOLD używa czcionki o grubości 750.
  • EXTRA_BOLD używa czcionki o grubości 800.
  • BLACK używa czcionki o grubości 900.
  • EXTRA_BLACK używa czcionki o grubości 1000.

Elementy wewnętrzne

Element Font może zawierać te elementy wewnętrzne: