ColorConfiguration
umożliwia użytkownikowi zmianę koloru elementów tarczy zegarka w edytorze tarcz.
Gdy atrybut ColorConfiguration
jest zdefiniowany, dowolny atrybut koloru innego elementu, np. tintColor
, może odnosić się do koloru z konfiguracji za pomocą wyrażenia, które korzysta z wartości identyfikatora w ColorConfiguration
i ColorOption
. Pełną prezentację znajdziesz tutaj.
Wprowadzona w Wear OS 4.
Składnia
<ColorConfiguration id="string" displayName="string" icon="string" screenReaderText="string" defaultValue="string"> <ColorOption id="string" displayName="string" screenReaderText="string" icon="string" colors="argb-color-list" /> ... </ColorConfiguration>
Przykład
Załóżmy, że zdefiniowano tę konfigurację koloru z wartością identyfikatora themeColor
:
<ColorConfiguration id="themeColor" defaultValue="0"
displayName="color_selector_display_name">
<ColorOption id="0" displayName="color_theme_0" colors="#ff000000 #ff888888 #ffffffff"/>
<ColorOption id="1" displayName="color_theme_1" colors="#ffff0000 #ffff8800 #ffffff00"/>
<ColorOption id="2" displayName="color_theme_2" colors="#ff00ff00 #ff00ff88 #ff00ffff"/>
<ColorOption id="3" displayName="color_theme_3" colors="#ff0000ff #ff8800ff #ffff00ff"/>
</ColorConfiguration>
Ta konfiguracja reprezentuje 4 palety do wyboru, z których każda zawiera 3 kolory.
Jeśli atrybut colors
zawiera tylko jedną wartość, odwołaj się do motywu w następujący sposób, aby na przykład ustawić tintColor
:
<PartText ... tintColor="[CONFIGURATION.themeColor]">
Jeśli atrybut colors
zawiera paletę więcej niż 1 wartości, określ indeks w sposób pokazany w poniższym przykładzie. Ten przykład pokazuje wybór drugiego koloru w wybranym ColorOption
:
<PartText ... tintColor="[CONFIGURATION.themeColor.1]">
Atrybuty
Element ColorConfiguration
ma te atrybuty:
Atrybuty wymagane
Wymagane są te atrybuty:
id
- Unikalny identyfikator wartości konfiguracji.
displayName
- Identyfikator zasobu odpowiadający tekstowi wyświetlanemu w edytorze tarczy zegarka.
defaultValue
- Domyślna wartość konfiguracji używana, gdy użytkownik nie zmieni konfiguracji w edytorze tarczy zegarka. Powinna być ustawiona na
id
jednego z wewnętrznych elementówColorOption
.
Atrybuty opcjonalne
Te atrybuty są opcjonalne:
icon
- Identyfikator zasobu odpowiadający obiektowi rysowalnemu, który jest wyświetlany w edytorze tarczy zegarka. Jego maksymalny rozmiar to 400 x 400 pikseli.
screenReaderText
- Identyfikator zasobu odpowiadający tekstowi używanemu, gdy użytkownik ma włączoną funkcję TalkBack.
Elementy wewnętrzne
Element ColorConfiguration
może zawierać od 1 do 100 wewnętrznych elementów ColorOption
.
Atrybuty ColorOption
Element ColorOption
musi zawierać te atrybuty:
id
- Unikalny identyfikator wartości opcji.
displayName
- Identyfikator zasobu odpowiadający tekstowi wyświetlanemu w edytorze tarczy zegarka.
Element ColorOption
musi zawierać jeden z tych atrybutów:
colors
- Lista oddzielonych spacjami wartości kolorów ARGB.
Element ColorOption
może opcjonalnie zawierać te atrybuty:
icon
- Identyfikator zasobu odpowiadający obiektowi rysowalnemu, który jest wyświetlany w edytorze tarczy zegarka.
screenReaderText
- Identyfikator zasobu odpowiadający tekstowi używanemu, gdy użytkownik ma włączoną funkcję TalkBack.
Polecane dla Ciebie
- Uwaga: tekst linku wyświetla się, gdy JavaScript jest wyłączony
- ColorConfiguration (Konfiguracja koloru)
- Smak
- Smak