Czcionka

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

Aby użyć czcionki niestandardowej, umieść plik czcionek w pliku res/fonts/, korzystając z jednego z akceptowanych rozszerzeń plików czcionek: TTF, OTF, TTC lub XML. Następnie wpisz tę wartość na nazwę pliku czcionek, pomijając rozszerzenie na końcu.

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

size

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

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

color
Kolor tekstu. Jeśli podasz kolor, 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ść domyślna to 0. Przykładem niewielkiego rozwinięcia może być 0,05. Wartości ujemne wzmacniają tekst.
slant
Określ, czy użyć skali czcionki NORMAL (domyślna) czy ITALIC.
width

Wyliczenie kilku wskazówek dotyczących wariantu rodziny czcionek, którego należy użyć. Wartością domyślną jest NORMAL, która stosuje „normalną” wersję czcionki.

Poniższa lista zawiera inne wartości wyliczeniowe i odpowiednie warianty rodzin czcionek, których używają, jeśli dany wariant jest dostępny dla danej czcionki:

  • ULTRA_CONDENSED i EXTRA_CONDENSED używają wariantu „skondensowanego lekkiego”.
  • Parametr CONDENSED używa wariantu „skróconego”.
  • SEMI_CONDENSED używa wariantu typu „skondensowany średni”.
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED i ULTRA_EXPANDED używają wariantu „normalnego”.
weight

Lista kilku możliwych wag czcionek. Wartością domyślną jest NORMAL, co ma zastosowanie do wagi 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:

  • Uwaga: tekst linku jest wyświetlany, gdy JavaScript jest wyłączony
  • Plan
  • OutGlow
  • Cień