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