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 elementosColorOption
internos.
Atributos opcionales
Los siguientes atributos son opcionales:
icon
- 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 x 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.
Recomendaciones para ti
- Nota: El texto del vínculo se muestra cuando JavaScript está desactivado
- ColorConfiguration
- Sabor
- Sabor