加權

自第 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 都有顏色 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 元素可包含下列元素：