Farbkonfiguration

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

Wenn ein ColorConfiguration definiert ist, kann ein farbbasiertes Attribut eines anderen -Element wie tintColor kann sich auf eine Farbe aus der Konfiguration mithilfe eines Ausdrucks, der die ID-Werte von ColorConfiguration und ColorOption. 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 besteht aus vier Paletten, die jeweils drei Farben.

Wenn das Attribut colors nur einen einzigen Wert enthält, verweisen Sie auf das Thema. So legen Sie beispielsweise einen tintColor fest:

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

Wenn das Attribut colors eine Palette mit mehr als einem Wert enthält, Verweisen Sie auf den Index, wie im folgenden Beispiel gezeigt. Insbesondere diese Beispiel für die Auswahl der zweiten Farbe im ausgewählten ColorOption:

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

Attribute

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 auf der Smartwatch angezeigten Text entspricht Gesichtsbearbeitung.

defaultValue

Der Wert für die Standardkonfiguration, der verwendet wird, wenn der Nutzer dies nicht explizit ändert die Konfiguration im Zifferblatt-Editor. Sollte auf die id von Eines der inneren ColorOption-Elemente.

Optionale Attribute

Die folgenden Attribute sind optional:

icon

Eine Ressourcen-ID, die der Drawable-Ressource entspricht, die in angezeigt wird Zifferblatt-Editor. 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.

Innere Elemente

Das ColorConfiguration-Element kann einen inneren Wert zwischen 1 und 100 enthalten ColorOption-Elemente.

ColorOption-Attribute

Das ColorOption-Element muss die folgenden Attribute enthalten:

id

Eine eindeutige Kennung für den Optionswert.

displayName

Eine Ressourcen-ID, die dem auf der Smartwatch angezeigten Text entspricht Gesichtseditor

Das ColorOption-Element muss eines der folgenden Attribute enthalten:

colors

Eine durch Leerzeichen getrennte Liste von ARGB-Farbwerten.

Das Element ColorOption kann optional Folgendes enthalten: Attribute:

icon

Eine Ressourcen-ID, die der Drawable-Ressource entspricht, die in angezeigt wird Zifferblatt-Editor.

screenReaderText

Eine Ressourcen-ID, die dem Text entspricht und der verwendet wird, wenn der Nutzer TalkBack aktiviert.