TimeText

Văn bản thời gian (time text) là một chuỗi được định dạng để thể hiện thời gian hiện tại.

Ra mắt trong Wear OS 4.

Cú pháp

<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" />

Thuộc tính

Phần tử TimeText có các thuộc tính như sau:

Thuộc tính bắt buộc

Các thuộc tính sau đây là bắt buộc:

format

Một chuỗi định dạng biểu thị định dạng thời gian.

Danh sách này bao gồm một số định dạng để hiển thị thời gian là 12:34:56 CH:

  • hh:mm:ss hiển thị là "12:34:56".
  • h:mm hiển thị là "12:34"
  • hh_10 hiển thị là "1".
  • hh_1 hiển thị là "2".
  • m hiển thị là "34"
  • mm_10 hiển thị là "3".
  • mm_1 hiển thị là "4".
  • ss hiển thị là "56"
  • ss_10 hiển thị là "5".
  • ss_1 hiển thị là "6".
x, y, width, height

Tập hợp số nguyên chỉ định kích thước và vị trí của phần tử.

Thuộc tính không bắt buộc

Các thuộc tính sau đây là không bắt buộc:

hourFormat
Xác định sẽ sử dụng ký hiệu 12 giờ hay 24 giờ để hiển thị thời gian. Giá trị mặc định là SYNC_TO_DEVICE, áp dụng lựa chọn ưu tiên của người dùng (đã được định cấu hình trên thiết bị).
align:
Cách căn chỉnh văn bản trong vùng giới hạn hình hộp. Giá trị mặc định là "START".
pivotX, pivotY
Điểm trung tâm hai chiều là điểm mà các phần tử xoay quanh. Cả hai đều là giá trị dấu phẩy động được điều chỉnh theo tỷ lệ để nằm trong khoảng $ [0, 1] $.
angle
Số độ (theo chiều kim đồng hồ) mà phần tử phải xoay quanh điểm trung tâm.
alpha
Thiết lập mức độ trong suốt mà phần tử này cần có. Giá trị 0 cho biết phần tử phải hoàn toàn trong suốt. Giá trị 255 cho biết phần tử phải hoàn toàn mờ đục.
tintColor
Áp dụng bộ lọc màu phủ màu cho phần tử. Bạn phải chỉ định màu bằng cách sử dụng định dạng ARGB (#ff000000 = màu đen tuyền) hoặc định dạng RGB (#000000 = màu đen).

Phần tử bên trong

Phần tử TimeText có thể chứa các phần tử bên trong sau đây:

Variant
Cho phép thay đổi các thuộc tính của phần tử này khi thiết bị Wear OS ở chế độ môi trường xung quanh. Bạn có thể xem thêm thông tin trong tài liệu tham khảo về Variant.
BitmapFont
Dùng BitmapFont để hiển thị thời gian.
Font
Dùng Font để hiển thị thời gian.