BoolescheKonfiguration

Eine boolesche Konfiguration bietet dem Nutzer eine Option, die beim Anpassen des Zifferblatts im Zifferblatteditor aktiviert oder deaktiviert werden kann.

In Wear OS 4 eingeführt.

Syntax

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

Sie können ein BooleanConfiguration-Element in ein Scene-Element einfügen, wie im folgenden Code-Snippet gezeigt:

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

Hinweis :BooleanConfiguration-Elemente können nicht in einem Scene verschachtelt werden, wenn Inhalte basierend auf dem Wert von zwei oder mehr Konfigurationsoptionen ausgewählt werden sollen. Wenn Sie Konfigurationsoptionen in Verbindung mit anderen Werten verwenden möchten, verwenden Sie stattdessen Condition. Beispiel:

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

Attribute

Das BooleanConfiguration-Element hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

id

Eine eindeutige Kennung für den Konfigurationswert.

displayName

Eine Ressourcen-ID, die dem Text entspricht, der im Zifferblatteditor angezeigt wird.

defaultValue

Der Standardkonfigurationswert, der verwendet wird, wenn der Nutzer die Konfiguration im Zifferblatteditor nicht explizit ändert.

Optionale Attribute

Die folgenden Attribute sind optional:

icon

Eine Ressourcen-ID, die der drawable-Ressource entspricht, die im Zifferblatt-Editor angezeigt wird. Es sollte eine maximale Größe von 400 × 400 Pixel haben.

screenReaderText

Eine Ressourcen-ID, die dem Text entspricht, der verwendet wird, wenn der Nutzer TalkBack aktiviert hat.