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 innerenColorOption
-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.
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- BoolescheKonfiguration
- ListConfiguration (Listenkonfiguration)
- Zusatzfunktion