شطب بالوزن

اعتبارًا من الإصدار 2

نمط سكتة مع أجزاء فردية، والذي يمكن أن يأخذ أوزانًا وألوانًا محددة. تُستخدم بشكل خاص في عرض إضافات GOAL_PROGRESS وRANGED_VALUE وWEIGHTED_ITEMS.

بناء الجملة

<WeightedStroke colors="argb-color-list" thickness="float"
    weights="weight-list" discreteGap="float" interpolate="boolean"
    cap="BUTT | ROUND | SQUARE" />

السمات

يحتوي العنصر WeightedStroke على السمات التالية:

السمات المطلوبة

السمات التالية مطلوبة:

colors

ألوان كل عنصر من الحد الخارجي المرجَّح، كقائمة مفصولة بمسافات من القيم السداسية العشرية، على سبيل المثال: #FF0000 #00FF00 #0000FF.

عند استخدامها لعرض بيانات الإضافة GOAL_PROGRESS أو RANGED_VALUE التي توفّر بيانات الألوان، أو باستخدام WEIGHTED_ELEMENTS، يمكن تعبئة colors مباشرةً بـ [COMPLICATION.GOAL_PROGRESS_COLORS] أو [COMPLICATION.RANGED_VALUE_COLORS] أو [COMPLICATION.WEIGHTED_ELEMENTS_COLORS].

thickness

سُمك الحد الذي يتم التعبير عنه في شكل بُعد عائم.

السمات الاختيارية

السمات التالية اختيارية:

weights

قائمة بالقيم مفصولة بمسافات تحدّد نسبة القوس الذي اكتسبه كل وزن، على سبيل المثال 1.0 2.0 3.0، حيث يشغل العنصر الثالث 3 أضعاف زاوية العنصر الأول.

عند استخدام هذه السمة لتمثيل بيانات من إضافة WEIGHTED_ELEMENTS، يمكن تمرير السمة [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS] مباشرةً.

discreteGap

الزاوية بين كل عنصر. وتكون القيمة التلقائية هي 0.0.

interpolate

عند الضبط على true، يحتوي كل عنصر N من قائمة weights على تدرج ألوان من N إلى اللون N+1 لقائمة colors، بدلاً من اللون الثابت.

عند استخدام هذه البيانات لتمثيل بيانات من إضافات GOAL_PROGRESS أو RANGED_VALUE، يمكنك تمرير قيم الحقول [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] أو [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE] مباشرةً. عند استخدامها لتمثيل بيانات الإضافة WEIGHTED_ELEMENTS، اضبط السمة interpolate على false.

وتكون القيمة التلقائية هي false.

cap

حدد شكل حافة الحد الخارجي. القيمتان المسموح بإدراجهما هما:

  • تتسبب BUTT في انتهاء الحد الخارجي بالمسار، وعدم عرضه بعده.
  • يؤدي ROUND إلى ظهور الخط على شكل نصف دائرة، مع تحديد المركز في نهاية المسار.
  • يتسبب SQUARE في ظهور الحد الخارجي كمربع، مع تحديد المركز في نهاية المسار.

العناصر الداخلية

يمكن أن يحتوي العنصر WeightedStroke على العناصر التالية: