یک شکاف عارضه ناحیه ای از صفحه ساعت است که کاربر می تواند یک Complication اضافه کند. شکاف‌های عارضه حاوی عناصر Complication هستند که نحوه نمایش Complication را برای انواع مختلف پیچیدگی و در حالت‌های مختلف صفحه ساعت تعریف می‌کنند.
در Wear OS 4 معرفی شد.
نحو
<ComplicationSlot x="integer" y="integer" width="integer"
height="integer" pivotX="float" pivotY="float"
angle="float-degrees" alpha="integer" slotId="integer"
name="string" displayName="string" scaleX="float" scaleY="float"
supportedTypes="string" isCustomizable="boolean"
tintColor="argb-color | rgb-color" />
ویژگی های
ComplicationSlot دارای ویژگی های زیر است:
ویژگی های مورد نیاز
ویژگی های زیر مورد نیاز است:
-
x،y،width،height - مجموعه ای از اعداد صحیح که اندازه و موقعیت عنصر را مشخص می کند.
-
slotId - یک شناسه عددی منحصر به فرد برای اسلات.
-
supportedTypes - لیستی از انواع پیچیدگی های پشتیبانی شده که می توانند اسلات را پر کنند. مقادیر پشتیبانی شده عبارتند از:
SHORT_TEXT،LONG_TEXT،MONOCHROMATIC_IMAGE،SMALL_IMAGE،PHOTO_IMAGE،RANGED_VALUE، وEMPTY. چندین نوع پیچیدگی را می توان با جدا کردن آنها با یک فاصله (به عنوان مثال،SHORT_TEXT RANGED_VALUE) پشتیبانی کرد.
ویژگی های اختیاری
ویژگی های زیر اختیاری هستند:
-
pivotX،pivotY - یک نقطه محوری دو بعدی که عنصر به دور آن می چرخد. هر دو مقدار، اعداد ممیز شناور هستند که برای قرار گرفتن در محدوده $ [0، 1] $ مقیاس بندی شده اند.
-
angle - تعدادی درجه، در جهت عقربه های ساعت، که عنصر باید حول نقطه محوری خود بچرخد.
-
alpha - سطح شفافیتی که این عنصر باید داشته باشد را تنظیم کنید. مقدار
0نشان می دهد که عنصر باید کاملا شفاف باشد. مقدار255نشان می دهد که عنصر باید کاملاً مات باشد. -
scaleX - ضریب مقیاس افقی برای اعمال این عنصر.
-
scaleY - ضریب مقیاس بندی عمودی برای اعمال این عنصر.
-
tintColor - یک فیلتر رنگی رنگی را روی عنصر اعمال کنید. شما باید رنگ را با استفاده از فرمت ARGB (
#ff000000= سیاه مات) یا فرمت RGB (#000000= سیاه) مشخص کنید. -
displayName - شناسه منبع مربوط به نام محلی برای شکاف عارضه، که در ویرایشگر صفحه ساعت نمایش داده می‌شود.
-
isCustomizable - تعیین می کند که آیا کاربر می تواند ارائه دهنده این شکاف را در ویرایشگر چهره ساعت تغییر دهد یا خیر. پیش‌فرض به
TRUEمی‌رسد.
عناصر درونی
عنصر ComplicationSlot باید دقیقاً حاوی یک عنصر Bounding Area باشد.
یک عنصر ComplicationSlot باید حداقل دارای یک عنصر Complication در هر نوع Complication پشتیبانی شده باشد. یک عنصر ComplicationSlot به صورت اختیاری می‌تواند حاوی عناصر Complication بیشتری باشد تا از تغییر ظاهر با عناصر Variant پشتیبانی کند.
عنصر ComplicationSlot همچنین می تواند شامل عناصر داخلی زیر باشد: