ColorConfiguration

Une configuration de couleur (ColorConfiguration) permet à l'utilisateur de modifier la couleur des éléments du cadran via l'éditeur de cadran.

Lorsqu'une ColorConfiguration est définie, tout attribut basé sur les couleurs d'un autre élément, tel que tintColor, peut faire référence à une couleur de la configuration à l'aide d'une expression qui utilise les valeurs d'ID de ColorConfiguration et un élément ColorOption. Pour voir une démonstration complète, consultez cet exemple.

Introduit dans Wear OS 4.

Syntaxe

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

Exemple

Supposons que la configuration de couleur suivante, avec l'ID themeColor, soit définie :

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

Cette configuration représente un choix de quatre palettes, chacune contenant trois couleurs.

Si l'attribut colors ne contient qu'une seule valeur, référencez le thème comme suit, par exemple pour définir un tintColor :

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

Si l'attribut colors contient une palette de plusieurs valeurs, référencez l'index comme indiqué dans l'exemple suivant. Plus précisément, cet exemple montre comment sélectionner la deuxième couleur dans l'élément ColorOption choisi :

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

Attributs

L'élément ColorConfiguration comporte les attributs suivants :

Attributs obligatoires

Les attributs suivants sont obligatoires :

id
Identifiant unique de la valeur de configuration.
displayName
ID de ressource correspondant au texte affiché dans l'éditeur de cadran.
defaultValue
Valeur de configuration par défaut si l'utilisateur ne modifie pas explicitement la configuration dans l'éditeur de cadran. Doit être définie sur l'id de l'un des éléments ColorOption internes.

Attributs facultatifs

Les attributs suivants sont facultatifs :

icon
ID de ressource correspondant à la ressource drawable, affiché dans l'éditeur de cadran. La taille ne doit pas dépasser 400 x 400 px.
screenReaderText
ID de ressource correspondant au texte utilisé si TalkBack a été activé.

Éléments internes

L'élément ColorConfiguration peut contenir entre 1 et 100 éléments ColorOption internes.

Attributs ColorOption

L'élément ColorOption doit contenir les attributs suivants :

id
Identifiant unique de la valeur de l'option.
displayName
ID de ressource correspondant au texte affiché dans l'éditeur de cadran.

L'élément ColorOption doit contenir l'un des attributs suivants :

colors
Liste de valeurs de couleur ARVB séparées par un espace

L'élément ColorOption peut aussi contenir les attributs suivants :

icon
ID de ressource correspondant à la ressource drawable, affiché dans l'éditeur de cadran.
screenReaderText
ID de ressource correspondant au texte utilisé si TalkBack a été activé.