شطب بالوزن

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

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

بناء الجملة

<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، يمكن تمرير [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 على العناصر التالية: