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żywać tej samej rodziny czcionek co system, ustaw tę wartość na SYNC_TO_DEVICE.

Aby użyć czcionki niestandardowej, umieść plik czcionki w języku res/fonts/, używając jednego z tych akceptowanych rozszerzeń: TTF, OTF, TTC lub XML. Następnie wpisz w tej wartości nazwę pliku czcionki 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 podany, musisz go określić w formacie ARGB (#ff000000 = nieprzezroczysta czerń) lub 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 skosem czcionki: NORMAL (domyślny) czy ITALIC.
width

Lista kilku wskazówek dotyczących odmiany rodziny czcionek. Wartość domyślna to NORMAL, co oznacza „normalny” wariant czcionki.

Poniższa lista zawiera inne wartości wyliczeniowe oraz odpowiednie warianty rodziny czcionek, jeśli są one dostępne dla danej czcionki:

  • ULTRA_CONDENSED i EXTRA_CONDENSED używają wariantu typu „skondensowany jasny”.
  • CONDENSED używa wariantu „skondensowanego”.
  • SEMI_CONDENSED używa wariantu „średni/skondensowany”.
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED i ULTRA_EXPANDED używają wariantu „normalnego”.
weight

Lista kilku możliwych grubości czcionek. Wartość domyślna to NORMAL, co oznacza wagę 400.

Poniższa lista zawiera inne wartości wyliczeniowe i odpowiadające im wagi 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: