חריץ משולב

חריץ לרכיב הוא אזור בתצוגת השעון שבו המשתמש יכול להוסיף רכיב. חריצי התכונות הנוספות מכילים אלמנטים של תכונה נוספת, שמגדירים את אופן הרינדור של התכונה הנוספת בסוגי תכונות נוספות שונים ובמצבים שונים של תצוגת השעון.

הוצגה ב-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
נקודת ציר דו-ממדית שסביבה הרכיב מסתובב. שני הערכים הם מספרי נקודה צפה (floating-point) שמתאימים לטווח $ [0, 1] $.
angle
מספר המעלות, בכיוון השעון, שבהן צריך לסובב את האלמנט סביב ציר הצירים שלו.
alpha
הגדרת רמת השקיפות של הרכיב הזה. הערך 0 מציין שהרכיב צריך להיות שקוף לחלוטין. הערך 255 מציין שהרכיב צריך להיות אטום לחלוטין.
scaleX
גורם לקביעת קנה מידה אופקי שחלה על הרכיב הזה.
scaleY
גורם לקביעת קנה מידה אנכי שיש להחיל על הרכיב הזה.
tintColor
החלת מסנן גוון צבע על הרכיב. צריך לציין את הצבע באמצעות פורמט ARGB‏ (#ff000000 = שחור אטום) או פורמט RGB‏ (#000000 = שחור).
displayName
מזהה משאב שתואם לשם המותאם לשוק המקומי של מקום ה-complication, שמוצג בכלי לעריכת תצוגת השעון.
isCustomizable
קובעת אם המשתמש יכול לשנות את הספק של היחידה הזו בכלי לעריכת תצוגת השעון. ברירת המחדל היא TRUE.

רכיבים פנימיים

רכיב ComplicationSlot חייב לכלול רכיב Bounding Area אחד בלבד.

רכיב ComplicationSlot חייב להכיל לפחות רכיב Complication לכל סוג Complication נתמך. אפשר גם לכלול ברכיב ComplicationSlot עוד אלמנטים של Complication כדי לתמוך בשינוי המראה באמצעות אלמנטים של Variant.

הרכיב ComplicationSlot יכול להכיל גם את הרכיבים הפנימיים הבאים:

  • הערה: טקסט הקישור מוצג כש-JavaScript מושבת
  • PartImage
  • PartText