RenkYapılandırması

ColorConfiguration, kullanıcıya kadran düzenleyici aracılığıyla kadran öğelerinin rengini değiştirme seçeneği sunar.

Bir ColorConfiguration tanımlandığında, tintColor gibi başka bir öğenin renk tabanlı herhangi bir özelliği, ColorConfiguration ve ColorOption öğelerinin kimlik değerlerini kullanan bir ifade kullanarak yapılandırmadaki bir renge başvurabilir. Eksiksiz bir demo için örneğe bakın.

Wear OS 4'te kullanıma sunuldu.

Sözdizimi

<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>

Örnek

Kimlik değeri themeColor olan aşağıdaki renk yapılandırmasının tanımlandığını varsayalım:

<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>

Bu yapılandırmada, her biri üç renk içeren dört palet seçeneği sunulur.

colors özelliği yalnızca tek bir değer içeriyorsa temaya aşağıdaki gibi referans verin. Örneğin, tintColor ayarlamak için:

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

colors özelliği birden fazla değerden oluşan bir palet içeriyorsa aşağıdaki örnekte gösterildiği gibi dizine referans verin. Özellikle bu örnekte, seçilen ColorOption içindeki ikinci rengin seçilmesi gösterilmektedir:

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

Özellikler

ColorConfiguration öğesi aşağıdaki özelliklere sahiptir:

Gerekli özellikler

Aşağıdaki özellikler gereklidir:

id
Yapılandırma değerinin benzersiz tanımlayıcısı.
displayName
Kadran düzenleyicide gösterilen metne karşılık gelen kaynak kimliği.
defaultValue
Kullanıcı, kadran düzenleyicisindeki yapılandırmayı açıkça değiştirmediğinde kullanılan varsayılan yapılandırma değeri. Bu, iç ColorOption öğelerinden birinin id değerine ayarlanmalıdır.

İsteğe bağlı özellikler

Aşağıdaki özellikler isteğe bağlıdır:

icon
Kadran düzenleyicide gösterilen çekilebilir kaynağa karşılık gelen kaynak kimliği. Bu boyut en fazla 400x400 piksel olmalıdır.
screenReaderText
Kullanıcıda TalkBack'i etkinleştirmişse kullanılan metne karşılık gelen kaynak kimliği.

İç öğeler

ColorConfiguration öğesi, 1 ile 100 arasında iç ColorOption öğesi içerebilir.

ColorOption Özellikleri

ColorOption öğesi aşağıdaki özellikleri içermelidir:

id
Seçenek değerinin benzersiz tanımlayıcısı.
displayName
Kadran düzenleyicide gösterilen metne karşılık gelen kaynak kimliği.

ColorOption öğesi, aşağıdaki özelliklerden birini içermelidir:

colors
ARGB renk değerlerinin boşlukla ayrılmış listesi.

ColorOption öğesi, isteğe bağlı olarak aşağıdaki özellikleri içerebilir:

icon
Kadran düzenleyicide gösterilen çekilebilir kaynağa karşılık gelen kaynak kimliği.
screenReaderText
Kullanıcıda TalkBack'i etkinleştirmişse kullanılan metne karşılık gelen kaynak kimliği.