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
iEMPTY
. 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:
Polecane dla Ciebie
- Uwaga: tekst linku wyświetla się, gdy JavaScript jest wyłączony
- Obraz części
- Obraz PartVectorImage
- Tekst części