Farbkonfiguration

Mit ColorConfiguration kann der Nutzer die Farbe von Elementen des Zifferblatts über den Zifferblatt-Editor ändern.

Wenn ein ColorConfiguration definiert ist, kann jedes farbbasierte Attribut eines anderen Elements, z. B. tintColor, auf eine Farbe aus der Konfiguration verweisen. Dazu wird ein Ausdruck verwendet, der die ID-Werte von ColorConfiguration und eines ColorOption verwendet. Eine vollständige Demonstration finden Sie im Beispiel.

Eingeführt in Wear OS 4.

Syntax

<ColorConfiguration id="string" displayName="string" icon="string"
                    screenReaderText="string" defaultValue="string">
  <ColorOption id="string" displayName="string" screenReaderText="string"
               icon="string" colors="argb-color-list" />
  ...
</ColorConfiguration>

Beispiel

Angenommen, die folgende Farbkonfiguration mit dem ID-Wert themeColor ist definiert:

<ColorConfiguration id="themeColor" defaultValue="0"
                    displayName="color_selector_display_name">
    <ColorOption id="0" displayName="color_theme_0" colors="#ff000000 #ff888888 #ffffffff"/>
    <ColorOption id="1" displayName="color_theme_1" colors="#ffff0000 #ffff8800 #ffffff00"/>
    <ColorOption id="2" displayName="color_theme_2" colors="#ff00ff00 #ff00ff88 #ff00ffff"/>
    <ColorOption id="3" displayName="color_theme_3" colors="#ff0000ff #ff8800ff #ffff00ff"/>
</ColorConfiguration>

Diese Konfiguration repräsentiert eine Auswahl von vier Paletten, die jeweils drei Farben enthalten.

Wenn das Attribut colors nur einen einzelnen Wert enthält, verweisen Sie so auf das Thema, z. B. um ein tintColor festzulegen:

<PartText ... tintColor="[CONFIGURATION.themeColor]">

Wenn das Attribut colors eine Palette mit mehr als einem Wert enthält, verweisen Sie wie im folgenden Beispiel auf den Index. In diesem Beispiel wird die zweite Farbe im ausgewählten ColorOption ausgewählt:

<PartText ... tintColor="[CONFIGURATION.themeColor.1]">

Merkmale

Das ColorConfiguration-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 ColorOption-Elemente festgelegt werden.

Optionale Attribute

Die folgenden Attribute sind optional:

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.

Innere Elemente

Das ColorConfiguration-Element kann zwischen 1 und 100 innere ColorOption-Elemente enthalten.

ColorOption-Attribute

Das ColorOption-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 ColorOption-Element muss eines der folgenden Attribute enthalten:

colors
Eine durch Leerzeichen getrennte Liste von ARGB-Farbwerten.

Das Element ColorOption kann optional die folgenden Attribute enthalten:

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.