ColorConfiguration

Uma ColorConfiguration oferece ao usuário a opção de mudar a cor dos elementos do mostrador do relógio pelo editor.

Quando uma ColorConfiguration é definida, qualquer atributo baseado em cores de outro elemento, como tintColor, pode se referir a uma cor da configuração usando uma expressão que use os valores de ID da ColorConfiguration e uma ColorOption. Para uma demonstração completa, consulte o exemplo.

Introduzido no Wear OS 4.

Sintaxe

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

Exemplo

Suponha que a seguinte configuração de cor, com um valor de ID de themeColor, esteja definida:

<ColorConfiguration id="themeColor" defaultValue="0"
                    displayName="color_selector_display_name">
    <ColorOption id="0" colors="#ff000000 #ff888888 #ffffffff"/>
    <ColorOption id="1" colors="#ffff0000 #ffff8800 #ffffff00"/>
    <ColorOption id="2" colors="#ff00ff00 #ff00ff88 #ff00ffff"/>
    <ColorOption id="3" colors="#ff0000ff #ff8800ff #ffff00ff"/>
</ColorConfiguration>

Essa configuração representa uma escolha de quatro paletas, cada uma contendo três cores.

Se o atributo colors tiver apenas um valor, faça referência ao tema da seguinte maneira, por exemplo, para definir um tintColor:

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

Se o atributo colors tiver uma paleta com mais de um valor, faça referência ao índice conforme mostrado no exemplo a seguir. Mais especificamente, este exemplo mostra como selecionar a segunda cor na ColorOption escolhida:

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

Atributos

O elemento ColorConfiguration tem os seguintes atributos:

Atributos obrigatórios

Os seguintes atributos são obrigatórios:

id
Um identificador exclusivo para o valor da configuração.
displayName
Um ID de recurso correspondente ao texto exibido no editor do mostrador do relógio.
defaultValue
O valor de configuração padrão usado se o usuário não mudar explicitamente a configuração no editor do mostrador do relógio. Ele precisa ser definido como o id de um dos elementos ColorOption internos.

Atributos opcionais

Os seguintes atributos são opcionais:

icon
Um ID de recurso correspondente ao drawable mostrado no editor do mostrador do relógio. Ele precisa ter um tamanho máximo de 400 x 400 px.
screenReaderText
Um ID de recurso correspondente ao texto usado se o usuário tiver ativado o TalkBack.

Elementos internos

O elemento ColorConfiguration pode conter entre 1 e 100 elementos ColorOption internos.

Atributos de ColorOption

O elemento ColorOption precisa conter os seguintes atributos:

id
Um identificador exclusivo para o valor da opção.
displayName
Um ID de recurso correspondente ao texto exibido no editor do mostrador do relógio.

O elemento ColorOption precisa conter um dos seguintes atributos:

colors
Uma lista separada por espaço de valores de cor ARGB.

Opcionalmente, o elemento ColorOption pode conter os seguintes atributos:

icon
Um ID de recurso correspondente ao recurso drawable mostrado no editor do mostrador do relógio.
screenReaderText
Um ID de recurso correspondente ao texto usado se o usuário tiver ativado o TalkBack.