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 innerenColorOption
-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.
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- ColorConfiguration
- Geschmack
- Geschmack