خانة إدخال المحتوى

"خانة الإضافة" هي مساحة في خلفية شاشة الساعة يمكن للمستخدم إضافة الإضافة إليها. تحتوي خانة الإضافات على عناصر إضافة تحدّد طريقة عرض الإضافة لأنواع الإضافات المختلفة وفي أوضاع خلفية شاشة الساعة المختلفة.

تم طرح هذه الميزة في الإصدار 4 من نظام التشغيل Wear OS.

بناء الجملة

<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 على عنصر منطقة حدود واحدًا فقط.

يجب أن يحتوي العنصر ComplicationSlot على عنصر إضافة على الأقل لكل نوع إضافة متوافق. يمكن أن يحتوي العنصر ComplicationSlot اختياريًا على المزيد من عناصر إضافة لإتاحة تغيير المظهر باستخدام عناصر الصيغة.

يمكن أن يحتوي العنصر ComplicationSlot أيضًا على العناصر الداخلية التالية: