字型

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

這項元素已在 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/fonts/，並使用以下其中一種可接受的字型檔案副檔名：TTF、OTF、TTP 或 XML。接著將這個值設為字型檔案名稱，但是結尾不包括副檔名。

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

size

指定文字大小的浮點值。

選用屬性

選用屬性包括：

color
文字的顏色。如果指定此屬性，您必須使用 ARGB 格式 (#ff000000 = 不透明黑) 或 RGB 格式 (#000000 = 黑色) 指定顏色。
letterSpacing
字母之間的間距，以 EM 單位指定。預設值為 0。舉例來說，小幅展開的範例為 0.05。負值會使文字更緊密。
slant
此屬性決定要使用 NORMAL 字型斜體 (預設) 或 ITALIC 斜體。
width

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

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

  • ULTRA_CONDENSED 和 EXTRA_CONDENSED 使用「condensed-light」變體。
  • CONDENSED 使用「condensed」變體。
  • SEMI_CONDENSED 使用「condensed-medium」變體。
  • SEMI_EXPANDED、EXPANDED、EXTRA_EXPANDED 和 ULTRA_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 元素可包含下列內部元素：