ColorConfiguration
, kullanıcıya kadran öğelerinin rengini kadran düzenleyicisini kullanarak değiştirme seçeneği sunar.
Bir ColorConfiguration
tanımlandığında tintColor
gibi başka bir öğenin renge dayalı herhangi bir özelliği, ColorConfiguration
ve ColorOption
kimlik değerlerini kullanan bir ifade kullanarak yapılandırmadaki bir renge başvurabilir. Tam bir tanıtım 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
Aşağıdaki renk yapılandırmasının themeColor
kimlik değerine sahip olduğunu 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ırma, her biri üç renk içeren dört palet seçeneğini temsil eder.
colors
özelliği yalnızca tek bir değer içeriyorsa temaya aşağıdaki gibi başvurun (örneğin, tintColor
ayarlamak için):
<PartText ... tintColor="[CONFIGURATION.themeColor]">
colors
özelliği birden fazla değer içeren bir palet içeriyorsa dizine aşağıdaki örnekte gösterildiği gibi referans verin. Ayrıntılı olarak 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ğeri için benzersiz bir tanımlayıcı.
displayName
- Kadran düzenleyicide gösterilen metne karşılık gelen bir kaynak kimliği.
defaultValue
- Kullanıcı, kadran düzenleyicideki yapılandırmayı açıkça değiştirmezse varsayılan yapılandırma değeri kullanılır. 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. Maksimum 400x400 piksel boyutunda olmalıdır.
screenReaderText
- Kullanıcı TalkBack'i etkinleştirmişse kullanılan metne karşılık gelen bir kaynak kimliği.
İç öğeler
ColorConfiguration
öğesi, 1 ile 100 arasında iç ColorOption
öğe içerebilir.
ColorOption Özellikleri
ColorOption
öğesi aşağıdaki özellikleri içermelidir:
id
- Seçenek değeri için benzersiz bir tanımlayıcı.
displayName
- Kadran düzenleyicide gösterilen metne karşılık gelen bir 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 bir kaynak kimliği.
screenReaderText
- Kullanıcı TalkBack'i etkinleştirmişse kullanılan metne karşılık gelen bir kaynak kimliği.
Sizin için önerilenler
- Not: Bağlantı metni JavaScript kapalıyken görüntülenir
- BooleYapılandırması
- ListConfiguration
- KomplikasyonAlanı