پیکربندی لیست

پیکربندی فهرست به کاربر امکان می‌دهد هنگام سفارشی‌سازی صفحه ساعت در ویرایشگر صفحه ساعت، یک مورد را از فهرست انتخاب کند.

در Wear OS 4 معرفی شد.

نحو

<ListConfiguration id="string" displayName="string" icon="string"
                         screenReaderText="string" defaultValue="string"
>
  <ListOption id="string" displayName="string" screenReaderText="string"
                  icon="string" />
  ...
</ListConfiguration>

صفات

عنصر ListConfiguration دارای ویژگی های زیر است:

ویژگی های مورد نیاز

ویژگی های زیر مورد نیاز است:

id

یک شناسه منحصر به فرد برای مقدار پیکربندی.

displayName

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

defaultValue

مقدار پیکربندی پیش‌فرض استفاده می‌شود اگر کاربر به‌صراحت پیکربندی را در ویرایشگر چهره ساعت تغییر ندهد. این باید روی id یکی از عناصر ListOption داخلی تنظیم شود.

ویژگی های اختیاری

ویژگی های زیر اختیاری هستند:

icon

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

screenReaderText

شناسه منبع متناظر با متن که اگر کاربر TalkBack را فعال کرده باشد، استفاده می‌شود.

عناصر درونی

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

ویژگی های ListOption

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

id

یک شناسه منحصر به فرد برای مقدار گزینه.

displayName

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

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

icon

شناسه منبع مربوط به منبع قابل کشیدن که در ویرایشگر صفحه ساعت نشان داده شده است. این باید حداکثر اندازه 400x400 پیکسل داشته باشد.

screenReaderText

شناسه منبع متناظر با متن که اگر کاربر TalkBack را فعال کرده باشد، استفاده می‌شود.