加权笔画

从版本 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.WEIGHTED_ELEMENTS_WEIGHTS]。

discreteGap

各个元素之间的角度。默认为 0.0。

interpolate

设置为 true 时，weights 列表中的每个元素 N 都有一种颜色 从颜色 N 到 colors 列表的 N+1 颜色，而不是 纯色

用于表示来自 GOAL_PROGRESS 或 RANGED_VALUE 的数据时 您可以传入 [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] 或 [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE] 字段。在以下环境中使用时 表示 WEIGHTED_ELEMENTS 复杂功能数据，将 interpolate 设置为 false。

默认为 false。

cap

确定描边边缘的形状。支持的值包括：

  • BUTT 会导致描边以路径结束，而不会超出路径。
  • ROUND 会导致描边以半圆形的形式超出路径，其中心位于路径末尾。
  • SQUARE 会导致描边以方形的形式超出路径，其中心位于路径末尾。

内部元素

WeightedStroke 元素可以包含以下元素：