Widżet


Widżet na widżet to obszar na tarczy zegarka, który może zawierać widżet dodane przez użytkownika. Przedziały na widżety zawierają elementy kompilacji, które określ sposób renderowania widżetu w przypadku różnych typów widżetów różnymi trybami 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. Wiele widżety można obsługiwać, rozdzielając je spacjami (na 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, które są skalowane, by mieściły się w przedziale $ [0, 1] $.
angle
Liczba stopni, zgodnie z którą element powinien być obrócony wokół i punktu przestawnego.
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. Musisz określić kolor za pomocą format ARGB (#ff000000 = nieprzezroczysta czerń) lub RGB (#000000 = czarny).
displayName
identyfikator zasobu odpowiadający zlokalizowanej nazwie przedziału na widżet; który jest widoczny w edytorze tarczy zegarka.
isCustomizable
Określa, czy użytkownik może zmienić dostawcę tego boksu na zegarku edytor twarzy. Domyślna wartość to TRUE.

Elementy wewnętrzne

Element ComplicationSlot musi zawierać dokładnie jeden Obszar graniczny .

Element ComplicationSlot musi zawierać co najmniej element kompilacja według obsługiwanego typu widżetu. Element ComplicationSlot może opcjonalnie zawierają więcej elementów kompilacji, które ułatwiają zmianę wyglądu przy użyciu Elementy wersji.

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

. .