Listenkonfiguration

Mit einer Listenkonfiguration kann der Nutzer ein Element aus einer Liste auswählen, wenn er das Zifferblatt im Zifferblatt-Editor anpasst.

Eingeführt in Wear OS 4.

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 Kennung 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. Dieses sollte auf das 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 Zifferblatteditor angezeigt wird.
screenReaderText
Eine Ressourcen-ID, die dem Text entspricht, 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 Zifferblatteditor angezeigt wird. Sie darf maximal 400 × 400 Pixel groß sein.
screenReaderText
Eine Ressourcen-ID, die dem Text entspricht, der verwendet wird, wenn der Nutzer TalkBack aktiviert hat.