Listenkonfiguration

Eine Listenkonfiguration ermöglicht es dem Nutzer, beim Anpassen des Zifferblatts im Zifferblatt-Editor ein Element aus einer Liste auszuwählen.

Mit Wear OS 4 eingeführt.

Syntax

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

Merkmale

Das ListConfiguration-Element hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

id
Eine eindeutige Kennzeichnung für den Konfigurationswert.
displayName
Eine Ressourcen-ID, die dem Text entspricht, der im Zifferblatt-Editor angezeigt wird.
defaultValue
Der Standardkonfigurationswert, der verwendet wird, wenn der Nutzer die Konfiguration im Zifferblatt-Editor nicht explizit ändert. Dies sollte auf den id eines der inneren ListOption-Elemente festgelegt werden.

Optionale Attribute

Die folgenden Attribute sind optional:

icon
Eine Ressourcen-ID, die der Drawable-Ressource entspricht, die im Zifferblatt-Editor angezeigt wird.
screenReaderText
Eine Ressourcen-ID, die dem Text entspricht und der verwendet wird, wenn der Nutzer TalkBack aktiviert hat.

Innere Elemente

Das ListConfiguration-Element kann 1 bis 100 innere ListOption-Elemente enthalten.

ListOption-Attribute

Das ListOption-Element muss die folgenden Attribute enthalten:

id
Eine eindeutige Kennung für den Optionswert.
displayName
Eine Ressourcen-ID, die dem Text entspricht, der im Zifferblatt-Editor angezeigt wird.

Das Element ListOption kann optional die folgenden Attribute enthalten:

icon
Eine Ressourcen-ID, die der Drawable-Ressource entspricht, die im Zifferblatt-Editor angezeigt wird. Die maximal zulässige Größe beträgt 400 × 400 Pixel.
screenReaderText
Eine Ressourcen-ID, die dem Text entspricht und der verwendet wird, wenn der Nutzer TalkBack aktiviert hat.