Konfiguracja kolorów

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ów ColorOption.

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.