Font

Cung cấp hướng dẫn kết xuất hình ảnh cho một thành phần văn bản cụ thể.

Ra mắt trong Wear OS 4.

Cú pháp

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

Thuộc tính

Phần tử Font có các thuộc tính như sau. Một số thuộc tính là bắt buộc, trong khi các thuộc tính khác là không bắt buộc.

Thuộc tính bắt buộc

Các thuộc tính sau đây là bắt buộc:

family

Tên phông chữ dùng để hiển thị văn bản. Để sử dụng cùng một phông chữ gia đình làm hệ thống, hãy đặt giá trị này thành SYNC_TO_DEVICE.

Để dùng phông chữ tuỳ chỉnh, hãy đặt tệp phông chữ trong res/font/ bằng một trong các đuôi tệp phông chữ được chấp nhận sau: TTF, OTF, TTC hoặc XML. Sau đó, đặt giá trị vào tên tệp phông chữ, ngoại trừ phần mở rộng ở cuối.

Nếu hệ thống không thể phân giải tệp phông chữ, thì phông chữ hệ thống sẽ được sử dụng.

size

Giá trị dấu phẩy động cho biết kích thước văn bản.

Thuộc tính không bắt buộc

Các thuộc tính sau đây là không bắt buộc:

color
Màu sắc của văn bản. Nếu được cung cấp, bạn phải chỉ định màu bằng cách sử dụng định dạng ARGB (#ff000000 = màu đen mờ) hoặc định dạng RGB (#000000 = màu đen).
letterSpacing
Khoảng trắng giữa các chữ cái, được chỉ định theo đơn vị EM. Giá trị mặc định là "0". Ví dụ cho phần mở rộng nhỏ có thể là 0,05. Giá trị âm thắt chặt văn bản.
slant
Liệu nên sử dụng phông chữ xiên NORMAL (mặc định) hay phông chữ xiên ITALIC.
width

Bảng liệt kê một số gợi ý về biến thể bộ phông chữ nên dùng. Giá trị mặc định là NORMAL, áp dụng biến thể "normal" (bình thường) của phông chữ.

Danh sách sau đây chứa các giá trị liệt kê khác và biến thể phông chữ tương ứng mà các giá trị đó sử dụng, nếu biến thể đó có sẵn cho phông chữ:

  • ULTRA_CONDENSED và EXTRA_CONDENSED sử dụng biến thể "condensed-light" (ít đậm).
  • CONDENSED sử dụng biến thể "condensed" (đậm).
  • SEMI_CONDENSED sử dụng biến thể "condensed-medium" (đậm vừa phải)
  • SEMI_EXPANDED, EXPANDED, EXTRA_EXPANDED và ULTRA_EXPANDED đều sử dụng biến thể "normal" (bình thường).
weight

Bảng liệt kê một số độ đậm phông chữ có thể có. Giá trị mặc định là NORMAL, áp dụng độ đậm là 400.

Danh sách sau đây chứa các giá trị liệt kê khác và độ đậm phông chữ tương ứng:

  • THIN sử dụng độ đậm phông chữ 100.
  • ULTRA_LIGHT sử dụng độ đậm phông chữ 150.
  • EXTRA_LIGHT sử dụng độ đậm phông chữ 200.
  • LIGHT sử dụng độ đậm phông chữ 300.
  • MEDIUM sử dụng độ đậm phông chữ 500.
  • SEMI_BOLD sử dụng độ đậm phông chữ 600.
  • ULTRA_BOLD sử dụng độ đậm phông chữ 750.
  • EXTRA_BOLD sử dụng độ đậm phông chữ 800.
  • BLACK sử dụng độ đậm phông chữ 900.
  • EXTRA_BLACK sử dụng độ đậm phông chữ 1000.

Phần tử bên trong

Phần tử Font có thể chứa các phần tử bên trong sau: