加權

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