Widżet


Widżet na widżet to obszar na tarczy zegarka, który użytkownik może dodać do widżetu. Boksy widżetów zawierają elementy kompilacji, które określają, jak jest renderowany 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 numeryczny boksu.
supportedTypes
Lista obsługiwanych typów kompilacji, które mogą wypełniać przedział. Obsługiwane wartości to SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE i EMPTY. Możesz obsługiwać różne typy widżetów, rozdzielając je spacjami (np. SHORT_TEXT RANGED_VALUE).

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

pivotX, pivotY
Dwuwymiarowy punkt przestawny, wokół którego obraca się element. Obie wartości to liczby zmiennoprzecinkowe, skalowane tak, by mieściły się w przedziale $ [0, 1] $.
angle
Liczba stopni, zgodnie z którą powinien być obrócony element wokół punktu obrotu.
alpha
Ustaw poziom przezroczystości, jaki powinien mieć ten element. Wartość 0 wskazuje, że element powinien być całkowicie przezroczysty. Wartość 255 wskazuje, że element powinien być całkowicie nieprzezroczysty.
scaleX
Współczynnik skalowania w poziomie, który ma zostać zastosowany do tego elementu.
scaleY
Współczynnik skalowania w pionie, który ma zostać zastosowany do tego elementu.
tintColor
Zastosuj filtr koloru odcienia do elementu. Kolor musisz określić w formacie ARGB (#ff000000 = nieprzezroczysta czerń) lub w formacie RGB (#000000 = czarny).
displayName
Identyfikator zasobu odpowiadający zlokalizowanej nazwie boksu na widżet wyświetlany w edytorze tarczy zegarka.
isCustomizable
Określa, czy użytkownik może zmienić dostawcę dla tego boksu w edytorze tarczy zegarka. Domyślna wartość to TRUE.

Elementy wewnętrzne

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

Element ComplicationSlot musi zawierać co najmniej element kompilacji w przypadku każdego obsługiwanego typu widżetu. Element ComplicationSlot może opcjonalnie zawierać więcej elementów kompilacji, aby ułatwić zmianę wyglądu elementów wariant.

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