Farbkonfiguration

Ein ColorConfiguration bietet dem Nutzer die Möglichkeit, die Farbe von Elementen des Zifferblatts über den Zifferblatt-Editor zu ändern.

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

Mit Wear OS 4 eingeführt.

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 stellt eine Auswahl aus vier Paletten mit jeweils drei Farben dar.

Wenn das Attribut colors nur einen einzelnen Wert enthält, verweisen Sie so auf das Thema, z. B. um einen 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. Insbesondere dieses Beispiel zeigt, wie die zweite Farbe im ausgewählten ColorOption ausgewählt wird:

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

Merkmale

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

Innere Elemente

Das ColorConfiguration-Element kann 1 bis 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 Zifferblatt-Editor angezeigt wird.
screenReaderText
Eine Ressourcen-ID, die dem Text entspricht und der verwendet wird, wenn der Nutzer TalkBack aktiviert hat.