ColorConfiguration

ColorConfiguration به کاربر این امکان را می دهد که رنگ عناصر صفحه ساعت را از طریق ویرایشگر صفحه ساعت تغییر دهد.

وقتی ColorConfiguration تعریف می‌شود، هر ویژگی مبتنی بر رنگ عنصر دیگری، مانند tintColor ، می‌تواند با استفاده از عبارتی که از مقادیر ID 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>

مثال

فرض کنید که پیکربندی رنگ زیر، با یک مقدار ID از 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
شناسه منبع مربوط به منبع قابل کشیدن که در ویرایشگر صفحه ساعت نشان داده شده است. این باید حداکثر اندازه 400x400 پیکسل داشته باشد.
screenReaderText
شناسه منبع متناظر با متن که اگر کاربر TalkBack را فعال کرده باشد، استفاده می‌شود.

عناصر درونی

عنصر ColorConfiguration می تواند شامل 1 تا 100 عنصر ColorOption داخلی باشد.

ویژگی های ColorOption

عنصر ColorOption باید دارای ویژگی های زیر باشد:

id
یک شناسه منحصر به فرد برای مقدار گزینه.
displayName
شناسه منبع مربوط به متنی که در ویرایشگر صفحه ساعت نمایش داده می شود.

عنصر ColorOption باید دارای یکی از ویژگی های زیر باشد:

colors
فهرستی از مقادیر رنگی ARGB با فاصله.

عنصر ColorOption به صورت اختیاری می تواند دارای ویژگی های زیر باشد:

icon
شناسه منبع مربوط به منبع قابل کشیدن که در ویرایشگر صفحه ساعت نشان داده شده است.
screenReaderText
شناسه منبع متناظر با متن که اگر کاربر TalkBack را فعال کرده باشد، استفاده می‌شود.
{% کلمه به کلمه %} {% آخر کلمه %} {% کلمه به کلمه %} {% آخر کلمه %}