Konfiguracja kolorów

ColorConfiguration umożliwia użytkownikowi zmianę koloru elementów. na tarczy zegarka.

Jeśli atrybut ColorConfiguration jest zdefiniowany, każdy atrybut zawierający kolor innego atrybutu element, np. tintColor, może odnosić się do koloru z konfiguracji za pomocą wyrażenia, które korzysta z wartości identyfikatora ColorConfiguration oraz 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

Przyjmijmy, że konfiguracja koloru o wartości ID to themeColor, zdefiniowano:

<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 w trzech kolorach.

Jeśli atrybut colors zawiera tylko jedną wartość, odwołaj się do motywu w ten sposób, aby ustawić tintColor:

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

Jeśli atrybut colors zawiera paletę więcej niż jednej wartości, zgodnie z poniższym przykładem. A konkretnie 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 na zegarku i edytor twarzy.

defaultValue

Domyślna wartość konfiguracji używana, gdy użytkownik nie zmienia bezpośrednio konfigurację w edytorze tarcz zegarka. Wartość powinna być ustawiona na id z jeden z wewnętrznych elementów ColorOption.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

icon

Identyfikator odpowiadający zasobowi rysowalnemu wyświetlanemu w polu używając edytora tarczy zegarka. Jego maksymalny rozmiar to 400 x 400 pikseli.

screenReaderText

Identyfikator zasobu odpowiadający tekstowi, który jest używany, jeśli użytkownik ma Funkcja TalkBack jest włączona.

Elementy wewnętrzne

Element ColorConfiguration może zawierać od 1 do 100 wewnętrznych ColorOption elementów.

Atrybuty ColorOption

Element ColorOption musi zawierać te atrybuty:

id

Unikalny identyfikator wartości opcji.

displayName

Identyfikator zasobu odpowiadający tekstowi wyświetlanemu na zegarku edytor twarzy.

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 elementy atrybuty:

icon

Identyfikator odpowiadający zasobowi rysowalnemu wyświetlanemu w polu w edytorze tarczy zegarka.

screenReaderText

Identyfikator zasobu odpowiadający tekstowi, który jest używany, jeśli użytkownik ma Funkcja TalkBack jest włączona.

.

.