Configurazione colore

Un ColorConfiguration offre all'utente la possibilità di modificare il colore degli elementi del quadrante tramite l'editor dei quadranti.

Quando viene definito un ColorConfiguration, qualsiasi attributo basato sul colore di un altro elemento, come tintColor, può fare riferimento a un colore della configurazione utilizzando un'espressione che utilizza i valori ID di ColorConfiguration e di ColorOption. Per una dimostrazione completa, vedi l'esempio.

Introdotta in Wear OS 4.

Sintassi

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

Esempio

Supponiamo che sia definita la seguente configurazione di colore, con un valore ID pari a 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>

Questa configurazione consente di scegliere tra quattro tavolozze, ciascuna contenente tre colori.

Se l'attributo colors contiene un solo valore, fai riferimento al tema come segue, ad esempio per impostare un tintColor:

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

Se l'attributo colors contiene una tavolozza di più valori, fai riferimento all'indice come mostrato nell'esempio seguente. In particolare, questo esempio mostra la selezione del secondo colore nel criterio ColorOption scelto:

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

Attributi

L'elemento ColorConfiguration ha i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

id
Un identificatore univoco per il valore di configurazione.
displayName
Un ID risorsa corrispondente al testo visualizzato nell'editor dei quadranti.
defaultValue
Il valore di configurazione predefinito utilizzato se l'utente non modifica esplicitamente la configurazione nell'editor dei quadranti. Deve essere impostato sul valore id di uno degli elementi ColorOption interni.

Attributi facoltativi

I seguenti attributi sono facoltativi:

icon
Un ID risorsa corrispondente alla risorsa disegnabile che viene visualizzata nell'editor dei quadranti. Deve avere una dimensione massima di 400 x 400 px.
screenReaderText
Un ID risorsa corrispondente al testo utilizzato se l'utente ha abilitato TalkBack.

Elementi interni

L'elemento ColorConfiguration può contenere da 1 a 100 elementi ColorOption interni.

Attributi ColorOption

L'elemento ColorOption deve contenere i seguenti attributi:

id
Un identificatore univoco per il valore dell'opzione.
displayName
Un ID risorsa corrispondente al testo visualizzato nell'editor dei quadranti.

L'elemento ColorOption deve contenere uno dei seguenti attributi:

colors
Un elenco separato da spazi di valori colore ARGB.

L'elemento ColorOption può facoltativamente contenere i seguenti attributi:

icon
Un ID risorsa corrispondente alla risorsa disegnabile che viene mostrata nell'editor dei quadranti.
screenReaderText
Un ID risorsa corrispondente al testo utilizzato se l'utente ha abilitato TalkBack.