字体

提供特定文本元素的渲染说明。

在 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。然后，将此值设置为字体文件名，不包括末尾的扩展名。

如果无法解析字体文件，则使用系统字体。

大小

指定文本大小的浮点值。

可选属性

以下属性是可选的

颜色
文本的颜色。如果提供，则必须使用 ARGB 格式（#ff000000 = 不透明黑色）或 RGB 格式（#000000 = 黑色）指定颜色。
字母间距
字母之间的间距，以 EM 单位指定。默认值为 0。稍微扩展的示例可以是 0.05。负值会使文本更紧密。
倾斜
是否使用NORMAL字体倾斜（默认）或ITALIC倾斜。
宽度

几个提示的枚举，用于使用字体系列变体。默认值为NORMAL，它应用字体的“正常”变体。

以下列表包含其他枚举值以及它们使用的相应字体系列变体（如果该变体对字体可用）

  • ULTRA_CONDENSED和EXTRA_CONDENSED使用“condensed-light”变体。
  • CONDENSED使用“condensed”变体。
  • SEMI_CONDENSED使用“condensed-medium”变体。
  • SEMI_EXPANDED、EXPANDED、EXTRA_EXPANDED和ULTRA_EXPANDED都使用“normal”变体。
粗细

几个可能的字体粗细的枚举。默认值为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元素可以包含以下内部元素