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

تتيح علامة 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