字体

<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_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 元素可以包含以下内部元素：