字体

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

此元素在 Wear OS 4 中推出。

语法

<Font family="string | SYNC_TO_DEVICE" size="float"
      color="argb-color | rgb-color" slant="NORMAL | ITALIC"
      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 |
              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
size
一个浮点值,用于指定文本大小。

可选属性

以下属性是可选属性:

color
文本的颜色。如果提供,您必须使用 ARGB 格式(#ff000000 = 不透明的黑色)或 RGB 格式(#000000 = 黑色)指定颜色。
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 元素可以包含以下内部元素:

  • 注意:当 JavaScript 处于关闭状态时,系统会显示链接文字
  • Outline
  • OutGlow
  • Shadow