TimeText

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

时间文本是表示当前时间的格式化字符串。

此元素在 Wear OS 4 中推出。

语法

<TimeText format="string" hourFormat="12 | 24 | SYNC_TO_DEVICE"
             align="START | CENTER | END" x="integer" y="integer"
             width="integer" height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer"
             tintColor="argb-color | rgb-color" />

属性

TimeText 元素具有以下属性:

必需属性

以下属性是必需属性:

format

表示时间格式的格式字符串。

此列表包含几种不同的格式,用于显示中午 12:34:56 的时间:

  • hh:mm:ss 将呈现为“12:34:56”。
  • h:mm 将呈现为“12:34”
  • hh_10 将呈现为“1”。
  • hh_1 将呈现为“2”。
  • m 将呈现为“34”
  • mm_10 将呈现为“3”。
  • mm_1 将呈现为“4”。
  • ss 将呈现为“56”
  • ss_10 将呈现为“5”。
  • ss_1 将呈现为“6”。
xywidthheight

用于指定元素的尺寸和位置的整数集合。

可选属性

以下属性是可选属性:

hourFormat
表示使用 12 小时制还是 24 小时制来显示时间。默认设置为 SYNC_TO_DEVICE,这样即会应用在设备上配置的用户偏好设置。
align
如何对齐边界框内的文本。默认设置为“START”。
pivotXpivotY
表示元素围绕其旋转的二维轴心点。这两个值都是浮点数,且均会经过调整以符合 $ [0, 1] $ 这一范围。
angle
表示元素围绕轴心点顺时针旋转时应遵循的角度值。
alpha
用于设置此元素应具有的透明度。值 0 表示此元素应是完全透明的。值 255 表示此元素应是完全不透明的。
tintColor
对此元素应用色调滤镜。您必须使用 ARGB 格式(#ff000000 = 不透明的黑色)或 RGB 格式(#000000 = 黑色)来指定颜色。

内部元素

TimeText 元素可以包含以下内部元素:

Variant
允许在 Wear OS 设备处于氛围模式时更改此元素的属性。如需了解详情,请参阅 Variant 参考文档。
BitmapFont
用于渲染时间的 BitmapFont
Font
用于渲染时间的 Font