字型


此元素可針對特定文字元素提供轉譯指示。

這項元素已在 Wear OS 4 推出。

語法

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

屬性

Font 元素包含下列屬性,分為必要和選用屬性。

必要屬性

必要屬性包括:

family

用來轉譯文字的字型名稱。使用相同的字型 系列做為系統,請將此值設為 SYNC_TO_DEVICE

如要使用自訂字型,請將字型檔案置於 res/font/ 中,並使用 下列可接受的字型副檔名:TTF、OTF、TTC 或 XML。然後設定 的值變更為字型檔案的名稱,但不包含結尾的副檔名。

如果無法解析字型檔案,則會使用系統字型。

size

指定文字大小的浮點值。

選用屬性

選用屬性包括:

color
文字的顏色。如果指定此屬性,您必須使用 ARGB 格式 (#ff000000 = 不透明黑) 或 RGB 格式 (#000000 = 黑色) 指定顏色。
letterSpacing
字母之間的空格,以 EM 為單位。預設值為 0。舉例來說,假設廣告活動稍有展開,畫面可能為 0.05。負值會讓文字更窄。
slant
此屬性決定要使用 NORMAL 字型斜體 (預設) 或 ITALIC 斜體。
width

此屬性列舉了字型系列變體要使用的數個微調設定。預設值為 NORMAL,這會套用字型的「normal」變體。

您可以在下方清單中查看其他列舉值,以及這些值分別使用的字型系列變體 (如果適用於該字型的話):

  • ULTRA_CONDENSEDEXTRA_CONDENSED 使用「condensed-light」變體。
  • CONDENSED 使用「condensed」變體。
  • SEMI_CONDENSED 使用「condensed-medium」變體。
  • SEMI_EXPANDEDEXPANDEDEXTRA_EXPANDEDULTRA_EXPANDED 皆使用「normal」變體。
weight

此屬性列舉了幾種可能的字型粗細。預設值為 NORMAL,表示套用的粗細為 400

您可以在下方清單中查看其他列舉值,以及對應的字型粗細:

  • THIN 使用的字型粗細為 100
  • ULTRA_LIGHT 使用的字型粗細為 150
  • EXTRA_LIGHT 使用的字型粗細為 200
  • LIGHT 使用的字型粗細為 300
  • MEDIUM 使用的字型粗細為 500
  • SEMI_BOLD 使用的字型粗細為 600
  • ULTRA_BOLD 使用的字型粗細為 750
  • EXTRA_BOLD 使用的字型粗細為 800
  • BLACK 使用的字型粗細為 900
  • EXTRA_BLACK 使用的字型粗細為 1000

內部元素

Font 元素可包含下列內部元素: