Widżet

Widżet to obszar na tarczy zegarka, do którego użytkownik może dodać widżet. Widżety zawierają elementy, które określają sposób renderowania widżetu w przypadku różnych typów widżetów i różnych trybów tarczy zegarka.

Wprowadzona w Wear OS 4.

Składnia

<ComplicationSlot x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer" slotId="integer"
             name="string" displayName="string" scaleX="float" scaleY="float"
             supportedTypes="string" isCustomizable="boolean"
             tintColor="argb-color | rgb-color" />

Atrybuty

ComplicationSlot ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

x, y, width, height
Zbiór liczb całkowitych, które określają rozmiar i pozycję elementu.
slotId
Unikalny identyfikator liczbowy boksu.
supportedTypes
Lista obsługiwanych typów widżetów, które mogą wypełnić boks. Obsługiwane wartości to SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE i EMPTY. Można używać wielu typów widżetów, rozdzielając je spacją (np. SHORT_TEXT RANGED_VALUE).

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

pivotX, pivotY
Dwuwymiarowy punkt obrotu, wokół którego obraca się element. Obie wartości to liczby zmiennoprzecinkowe, które są przeskalowane w celu dopasowania do zakresu $ [0, 1] $.
angle
O kilka stopni w prawo, o ile element powinien być obrócony względem swojego punktu obrotu.
alpha
Ustaw poziom przejrzystości, jaki powinien mieć ten element. Wartość 0 oznacza, że element powinien być całkowicie przezroczysty. Wartość 255 oznacza, że element powinien być całkowicie nieprzezroczysty.
scaleX
Współczynnik skalowania w poziomie stosowany do tego elementu.
scaleY
Współczynnik skalowania w pionie stosowany do tego elementu.
tintColor
Zastosuj do elementu filtr koloru odcienia. Kolor musisz określić w formacie ARGB (#ff000000 = nieprzezroczysta czerń) lub RGB (#000000 = czarny).
displayName
Identyfikator zasobu odpowiadający zlokalizowanej nazwie boksu widżetu, który jest wyświetlany w edytorze tarcz zegarka.
isCustomizable
Określa, czy użytkownik może zmienić dostawcę tego boksu w edytorze tarczy zegarka. Domyślna wartość to TRUE.

Elementy wewnętrzne

Element ComplicationSlot musi zawierać dokładnie 1 element Obszar granicy.

Element ComplicationSlot musi zawierać co najmniej jeden element widżet w przypadku każdego obsługiwanego typu widżetu. Element ComplicationSlot może opcjonalnie zawierać więcej elementów Widżetu na potrzeby obsługi zmiany wyglądu za pomocą elementów Wersja.

Element ComplicationSlot może też zawierać te elementy wewnętrzne: