TimeText


時間文字是經過格式化的字串,代表目前時間。

這項元素已在 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
與元素旋轉方向相關的 2D 樞紐點。兩個值都是浮點數,可在 $ [0, 1] $ 範圍內視需求調整。
angle
元素應以順時針方向從樞紐點旋轉的角度數值。
alpha
此屬性可設定元素應具備的透明度。如果值為 0,表示元素應完全透明;值為 255 表示元素應完全不透明。
tintColor
為元素套用色調顏色濾鏡。您必須使用 ARGB 格式 (#ff000000 = 不透明黑) 或 RGB 格式 (#000000 = 黑) 指定顏色。

內部元素

TimeText 元素可包含下列內部元素:

Variant
允許在 Wear OS 裝置處於微光模式時變更元素屬性。詳情請參閱 Variant 參考資料。
BitmapFont
用於顯示時間的 BitmapFont
Font
用於顯示時間的字型
,瞭解如何調查及移除這項存取權。