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ówColorOption
.
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.
Polecane dla Ciebie
- Uwaga: tekst linku jest wyświetlany, gdy JavaScript jest wyłączony
- Wartość logiczna
- Konfiguracja listy
- ComplicationSlot.