تتيح ColorConfiguration
للمستخدم تغيير لون عناصر خلفية شاشة الساعة من خلال محرِّر خلفية شاشة الساعة.
عند تحديد ColorConfiguration
، يمكن لأي سمة مستندة إلى اللون لعنصر آخر، مثل tintColor
، أن تشير إلى لون من الإعدادات باستخدام تعبير يستخدم قيمتَي رقم التعريف ColorConfiguration
وColorOption
. للحصول على شرح كامل، يمكنك الاطّلاع على المثال.
تم طرح هذا الإصدار في نظام التشغيل Wear OS 4.
بناء الجملة
<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>
مثال
لنفترض أنّه تم تحديد إعدادات الألوان التالية، التي تتضمّن قيمة رقم التعريف themeColor
:
<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>
تمثل هذه التهيئة إمكانية الاختيار من أربع لوحات، تحتوي كل منها على ثلاثة ألوان.
إذا كانت السمة colors
تحتوي على قيمة واحدة فقط، يمكنك الإشارة إلى الموضوع على النحو التالي، مثلاً لضبط tintColor
:
<PartText ... tintColor="[CONFIGURATION.themeColor]">
إذا كانت السمة colors
تحتوي على لوحة تضم أكثر من قيمة واحدة،
يمكنك الرجوع إلى الفهرس كما هو موضّح في المثال التالي. يوضّح هذا المثال على وجه التحديد اختيار اللون الثاني في سمة ColorOption
التي تم اختيارها:
<PartText ... tintColor="[CONFIGURATION.themeColor.1]">
السمات
يحتوي العنصر ColorConfiguration
على السمات التالية:
السمات المطلوبة
السمات التالية مطلوبة:
id
- معرّف فريد لقيمة الضبط.
displayName
- معرّف مصدر مطابق للنص المعروض في أداة تعديل خلفية شاشة الساعة
defaultValue
- قيمة الضبط التلقائية المُستخدَمة إذا لم يغيّر المستخدم الإعدادات بشكل صريح في أداة تعديل خلفية شاشة الساعة. ويجب ضبطها على
id
لأحد عناصرColorOption
الداخلية.
السمات الاختيارية
السمات التالية اختيارية:
icon
- معرّف مصدر يشير إلى المورد القابل للرسم الذي يظهر في محرِّر خلفية شاشة الساعة ويجب ألّا يزيد حجم الملف عن 400×400 بكسل.
screenReaderText
- رقم تعريف مصدر يتوافق مع النص المُستخدَم في حال تفعيل TalkBack.
العناصر الداخلية
ويمكن أن يحتوي العنصر ColorConfiguration
على ما بين عنصر واحد و100 عنصر ColorOption
داخلي.
سمات ColorOption
يجب أن يحتوي العنصر ColorOption
على السمات التالية:
id
- معرّف فريد لقيمة الخيار.
displayName
- معرّف مصدر مطابق للنص المعروض في أداة تعديل خلفية شاشة الساعة
يجب أن يحتوي العنصر ColorOption
على إحدى السمات التالية:
colors
- قائمة مفصولة بمسافات لقيم ألوان ARGB
يمكن أن يحتوي العنصر ColorOption
اختياريًا على السمات التالية:
icon
- معرّف مورد يتوافق مع المورد القابل للرسم الذي يظهر في محرِّر خلفية شاشة الساعة
screenReaderText
- رقم تعريف مصدر يتوافق مع النص المُستخدَم في حال تفعيل TalkBack.
أفلام مُقترَحة لك
- ملاحظة: يظهر نص الرابط عند إيقاف JavaScript
- ColorConfiguration
- النكهة
- النكهة