Czcionka

Wyświetla instrukcje renderowania określonego elementu tekstowego.

Wprowadzona 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 podane niżej atrybuty. Niektóre atrybuty są wymagane, a inne opcjonalne.

Atrybuty wymagane

Wymagane są te atrybuty:

family

Nazwa czcionki używanej do renderowania tekstu. Aby użyć tej samej czcionki rodziny jako systemu, ustaw tę wartość na SYNC_TO_DEVICE.

Aby użyć czcionki niestandardowej, umieść plik czcionki w zakresie res/font/, używając jednego z z akceptowanymi rozszerzeniami plików czcionek: TTF, OTF, TTC lub XML. Następnie ustaw ten element to nazwa pliku czcionek, bez rozszerzenia na końcu.

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

size

Wartość zmiennoprzecinkowa, która określa rozmiar tekstu.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

color
Kolor tekstu. Jeśli kolor jest dostępny, musisz użyć jednej z tych opcji: format ARGB (#ff000000 = nieprzezroczysta czerń) lub format RGB (#000000 = czarny).
letterSpacing
Odstęp między literami określony w jednostkach EM. Wartością domyślną jest 0. Na przykład niewielkie rozwinięcie może wynosić 0,05. Wartości ujemne zaciemniają tekst.
slant
Wybór między stylem czcionki NORMAL (domyślny) lub ITALIC.
width

Lista kilku wskazówek dotyczących odmiany rodziny czcionek. Domyślny ma wartość NORMAL, co oznacza zastosowanie wartości „normal” (normalnej), wersji czcionki.

Poniższa lista zawiera inne wartości wyliczeniowe oraz odpowiednie używanych odmian rodziny czcionek, jeśli dany wariant jest dostępny dla danej czcionki:

  • ULTRA_CONDENSED i EXTRA_CONDENSED używają trybu „światło skondensowane” wersji.
  • CONDENSED używa wartości „skondensowanej” wersji.
  • Funkcja SEMI_CONDENSED używa „medium skondensowanego” wersji.
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED i ULTRA_EXPANDED za sztukę użyj „normalnego” wersji.
weight

Lista kilku możliwych grubości czcionek. Wartość domyślna to NORMAL, który ma wagę 400.

Poniższa lista zawiera inne wartości wyliczenia i odpowiadające im grubości czcionek:

  • THIN ma grubość czcionki 100.
  • ULTRA_LIGHT ma grubość czcionki 150.
  • EXTRA_LIGHT ma grubość czcionki 200.
  • LIGHT ma grubość czcionki 300.
  • MEDIUM ma grubość czcionki 500.
  • SEMI_BOLD ma grubość czcionki 600.
  • ULTRA_BOLD ma grubość czcionki 750.
  • EXTRA_BOLD ma grubość czcionki 800.
  • BLACK ma grubość czcionki 900.
  • EXTRA_BLACK ma grubość czcionki 1000.

Elementy wewnętrzne

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

. .