Configurazione booleana

Una configurazione booleana offre all'utente un'opzione che può essere attivata o disattivata durante la personalizzazione del quadrante nell'editor.

Introdotta in Wear OS 4.

Sintassi

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

Puoi includere un elemento BooleanConfiguration in un elemento Scene, come mostrato nello snippet di codice seguente:

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

Nota: gli elementi BooleanConfiguration non possono essere nidificati all'interno di un Scene quando si tenta di selezionare i contenuti in base al valore di due o più opzioni di configurazione combinate. Per utilizzare le opzioni di configurazione in combinazione con altri valori, utilizza Condition. Ad esempio:

<Condition>
  <Expressions>
    <Expression name="show_date_and_time">
      <![CDATA[[CONFIGURATION.show_date] == "TRUE" && [CONFIGURATION.show_time] == "TRUE"]]>
    </Expression>
  </Expressions>
  ...
</Condition>

Attributi

L'elemento BooleanConfiguration prevede i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

id

Un identificatore univoco per il valore di configurazione.

displayName

Un ID risorsa corrispondente al testo visualizzato nell'editor del quadrante.

defaultValue

Il valore di configurazione predefinito utilizzato se l'utente non modifica esplicitamente la configurazione nell'editor del quadrante.

Attributi facoltativi

I seguenti attributi sono facoltativi:

icon

Un ID risorsa corrispondente alla risorsa drawable mostrata nell'editor del quadrante. Deve avere una dimensione massima di 400 x 400 px.

screenReaderText

Un ID risorsa corrispondente al testo utilizzato se l'utente ha attivato TalkBack.