ListConfiguration

Une configuration de liste permet à l'utilisateur de sélectionner un élément dans une liste lorsqu'il personnalise le cadran dans l'éditeur de cadran.

Introduit dans Wear OS 4.

Syntaxe

<ListConfiguration id="string" displayName="string" icon="string"
                         screenReaderText="string" defaultValue="string"
>
  <ListOption id="string" displayName="string" screenReaderText="string"
                  icon="string" />
  ...
</ListConfiguration>

Attributs

L'élément ListConfiguration 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 ListOption internes.

Attributs facultatifs

Les attributs suivants sont facultatifs :

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

Éléments internes

L'élément ListConfiguration peut contenir entre 1 et 100 éléments ListOption internes.

Attributs ListOption

L'élément ListOption 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 ListOption peut aussi contenir les attributs suivants :

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