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 elementiColorOption
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.
Consigliato per te
- Nota: il testo del link viene visualizzato quando JavaScript è disattivato
- Configurazione booleana
- Configurazione elenco
- Slot per le complicazioni