إعدادات الألوان

تتيح 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.