Konfiguracja kolorów

ColorConfiguration umożliwia zmianę koloru elementów tarczy zegarka za pomocą edytora tarcz zegarka.

Gdy zdefiniowany jest ColorConfiguration, dowolny oparty na kolorze atrybut innego elementu, np. tintColor, może się odwoływać do koloru z konfiguracji za pomocą wyrażenia, które korzysta z wartości identyfikatora w ColorConfiguration i ColorOption. Pełną prezentację znajdziesz w przykładzie.

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 o 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>

Taka konfiguracja reprezentuje wybór 4 palet, z których każda zawiera 3 kolory.

Jeśli atrybut colors zawiera tylko jedną wartość, określ motyw w ten sposób, na przykład aby ustawić tintColor:

<PartText ... tintColor="[CONFIGURATION.themeColor]">

Jeśli atrybut colors zawiera paletę z więcej niż 1 wartością, odwołaj się do indeksu w sposób pokazany w poniższym przykładzie. Ten przykład pokazuje wybór drugiego koloru w wybranym elemencie 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 w sytuacji, gdy użytkownik nie zmieni bezpośrednio konfiguracji w edytorze tarcz zegarka. Należy ustawić go na id jednego z wewnętrznych elementów ColorOption.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

icon
Identyfikator zasobu odpowiadający zasobowi, który można narysować, wyświetlany w edytorze tarczy zegarka. Powinien mieć maksymalny rozmiar 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 opcji 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 wartości kolorów ARGB oddzielonych spacjami.

Element ColorOption może opcjonalnie zawierać te atrybuty:

icon
Identyfikator zasobu odpowiadający zasobowi, który można narysować, wyświetlany w edytorze tarcz zegarka.
screenReaderText
Identyfikator zasobu odpowiadający tekstowi używanemu, gdy użytkownik ma włączoną funkcję TalkBack.