字体

<ph type="x-smartling-placeholder"></ph>

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

此元素在 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 元素可以包含以下内部元素: