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
iEMPTY
. 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: