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 birininid
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.
Sizin için önerilenler
- Not: JavaScript kapalıyken bağlantı metni gösterilir
- ColorConfiguration
- Aroma
- Aroma