BooleanConfiguration

Une configuration booléenne offre à l'utilisateur une option qui peut être activée ou désactivée lors de la personnalisation du cadran dans l'éditeur de cadran.

Introduit dans Wear OS 4.

Syntaxe

<BooleanConfiguration id="string" displayName="string" icon="string"
                         screenReaderText="string" defaultValue="TRUE | FALSE"
/>

Vous pouvez inclure un élément BooleanConfiguration dans un élément Scene, comme indiqué dans l'extrait de code suivant :

<UserConfigurations>
  <BooleanConfiguration id="show_date"
      displayName="show_date_label"
      screenReaderText="show_date_label"
      defaultValue="TRUE"
  />
</UserConfigurations>

<!-- ... -->

<Scene backgroundColor="#ff000000">
  <!-- ... -->

  <BooleanConfiguration id="show_date">
    <BooleanOption id="TRUE">
      <Group ...>
        <!-- ...Content to show date -->
      </Group>
    </BooleanOption>
    <BooleanOption id="FALSE">
      <Group ...>
        <!-- ...Content when date not required -->
      </Group>
    </BooleanOption>
  </BooleanConfiguration>

  <!-- ... -->
</Scene>

Attributs

L'élément BooleanConfiguration 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.

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