提供特定文本元素的渲染说明。
在 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，它应用字体的“正常”变体。以下列表包含其他枚举值以及它们使用的相应字体系列变体，如果字体提供该变体
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 元素可以包含以下内部元素