加权笔画

从版本 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 时，可以直接使用 [COMPLICATION.GOAL_PROGRESS_COLORS]、[COMPLICATION.RANGED_VALUE_COLORS] 或 [COMPLICATION.WEIGHTED_ELEMENTS_COLORS] 填充 colors。

thickness

描边的粗细，表示为浮点尺寸。

此属性是可转换的。

可选属性

以下属性是可选属性：

weights

以空格分隔的值列表，用于确定每个权重占据的弧度比例，例如 1.0 2.0 3.0，其中第三个元素占据的角度是第一个元素的 3 倍。

用于表示来自 WEIGHTED_ELEMENTS 复杂功能的数据时，可以直接传入 [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS]。

discreteGap

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

interpolate

设置为 true 后，weights 列表中的每个元素 N 都会采用从 colors 列表中的颜色 N 到颜色 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 元素可以包含以下元素：

• Transform