Font

Memberikan petunjuk rendering untuk elemen teks tertentu.

Diperkenalkan di Wear OS 4.

Sintaksis

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

Atribut

Elemen Font memiliki atribut berikut. Beberapa atribut wajib ada sedangkan yang lain bersifat opsional.

Atribut wajib

Atribut berikut wajib diisi:

family

Nama font yang digunakan untuk merender teks. Untuk menggunakan jenis font yang sama dengan sistem, tetapkan nilai ini ke SYNC_TO_DEVICE.

Untuk menggunakan font kustom, tempatkan file font dalam res/fonts/, menggunakan salah satu ekstensi file font yang diterima berikut: TTF, OTF, TTC, atau XML. Kemudian, tetapkan nilai ini ke nama file font, dengan mengecualikan ekstensi di bagian akhir.

Jika file font tidak dapat diselesaikan, font sistem akan digunakan.

size

Nilai floating point yang menentukan ukuran teks.

Atribut opsional

Atribut berikut bersifat opsional:

color
Warna teks. Jika disediakan, Anda harus menentukan warna menggunakan format ARGB (#ff000000 = hitam buram) atau format RGB (#000000 = hitam).
letterSpacing
Spasi antar huruf, ditentukan dalam unit EM. Nilai defaultnya adalah 0. Contoh untuk sedikit ekspansi bisa menjadi 0,05. Nilai negatif akan memperketat teks.
slant
Apakah akan menggunakan font miring NORMAL (default) atau miring ITALIC.
width

Enumerasi beberapa petunjuk untuk varian jenis font yang akan digunakan. Nilai defaultnya adalah NORMAL, yang menerapkan varian font "normal".

Daftar berikut berisi nilai enumerasi lain dan setiap varian jenis font yang digunakan, jika varian tersebut tersedia untuk font:

  • ULTRA_CONDENSED dan EXTRA_CONDENSED menggunakan varian "kondensasi cahaya".
  • CONDENSED menggunakan varian "ringkas".
  • SEMI_CONDENSED menggunakan varian "sedang dipadatkan".
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED, dan ULTRA_EXPANDED masing-masing menggunakan varian "normal".
weight

Enumerasi beberapa kemungkinan ketebalan font. Nilai defaultnya adalah NORMAL, yang menerapkan bobot 400.

Daftar berikut berisi nilai enumerasi lainnya dan ketebalan font-nya masing-masing:

  • THIN menggunakan ketebalan font 100.
  • ULTRA_LIGHT menggunakan ketebalan font 150.
  • EXTRA_LIGHT menggunakan ketebalan font 200.
  • LIGHT menggunakan ketebalan font 300.
  • MEDIUM menggunakan ketebalan font 500.
  • SEMI_BOLD menggunakan ketebalan font 600.
  • ULTRA_BOLD menggunakan ketebalan font 750.
  • EXTRA_BOLD menggunakan ketebalan font 800.
  • BLACK menggunakan ketebalan font 900.
  • EXTRA_BLACK menggunakan ketebalan font 1000.

Elemen dalam

Elemen Font dapat berisi elemen bagian dalam berikut: