ColorConfiguration

Un ColorConfiguration le da al usuario la opción de cambiar el color de los elementos de la cara de reloj a través del editor de caras de reloj.

Cuando se define un ColorConfiguration, cualquier atributo basado en el color de otro elemento, como tintColor, puede hacer referencia a un color de la configuración por medio de una expresión que usa los valores de ID de ColorConfiguration y un ColorOption. Para obtener una demostración completa, consulta el ejemplo.

Se introdujo en Wear OS 4.

Sintaxis

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

Ejemplo

Supongamos que se define la siguiente configuración de color, con un valor de ID de 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>

Esta configuración representa una elección de cuatro paletas, cada una con tres colores.

Si el atributo colors contiene un solo valor, haz referencia al tema de la siguiente manera, por ejemplo, para establecer un tintColor:

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

Si el atributo colors contiene una paleta de más de un valor, haz referencia al índice como se muestra en el siguiente ejemplo. Específicamente, en este ejemplo se muestra cómo seleccionar el segundo color en el ColorOption elegido:

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

Atributos

El elemento ColorConfiguration tiene los siguientes atributos:

Atributos obligatorios

Se requieren los siguientes atributos:

id
Un identificador inequívoco para el valor de configuración.
displayName
Un ID de recurso que corresponde al texto que se muestra en el editor de caras de reloj.
defaultValue
El valor predeterminado de configuración que se usa si el usuario no cambia los parámetros de forma explícita en el editor de caras de reloj. Se debe establecer en el id de uno de los elementos ColorOption internos.

Atributos opcionales

Los siguientes atributos son opcionales:

icon
Es un ID de recurso que corresponde al recurso de elementos de diseño que se muestra en el editor de caras de reloj. El tamaño máximo debe ser de 400 × 400 px.
screenReaderText
Un ID de recurso que corresponde al texto que se usa si el usuario habilitó TalkBack.

Elementos internos

El elemento ColorConfiguration puede contener entre 1 y 100 elementos ColorOption internos.

Atributos ColorOption

El elemento ColorOption debe contener los siguientes atributos:

id
Un identificador único para el valor de la opción.
displayName
Un ID de recurso que corresponde al texto que se muestra en el editor de caras de reloj.

El elemento ColorOption debe contener uno de los siguientes atributos:

colors
Es una lista de valores de color ARGB separados por espacios.

De manera opcional, el elemento ColorOption puede contener los siguientes atributos:

icon
Un ID de recurso que corresponde al recurso de elementos de diseño que se muestra en el editor de caras de reloj.
screenReaderText
Un ID de recurso que corresponde al texto que se usa si el usuario habilitó TalkBack.