Tập tạ

Kể từ phiên bản 2

Mẫu nét vẽ có các đoạn riêng lẻ, có thể có trọng số và màu. Dùng để kết xuất GOAL_PROGRESS, RANGED_VALUE và WEIGHTED_ELEMENTS chức năng.

Cú pháp

<WeightedStroke colors="argb-color-list" thickness="float"
    weights="weight-list" discreteGap="float" interpolate="boolean"
    cap="BUTT | ROUND | SQUARE" />

Thuộc tính

Phần tử WeightedStroke có các thuộc tính như sau:

Thuộc tính bắt buộc

Các thuộc tính sau đây là bắt buộc:

colors

Màu của mỗi phần tử của nét vẽ có trọng số, dưới dạng danh sách được phân tách bằng dấu cách giá trị hex, ví dụ: #FF0000 #00FF00 #0000FF.

Khi được dùng để kết xuất dữ liệu chức năng GOAL_PROGRESS hoặc RANGED_VALUE cung cấp dữ liệu màu hoặc với WEIGHTED_ELEMENTS, colors có thể được điền trực tiếp với [COMPLICATION.GOAL_PROGRESS_COLORS], [COMPLICATION.RANGED_VALUE_COLORS] hoặc [COMPLICATION.WEIGHTED_ELEMENTS_COLORS].

thickness

Độ dày của nét vẽ được biểu diễn dưới dạng kích thước bằng một số thực.

Thuộc tính không bắt buộc

Các thuộc tính sau đây là không bắt buộc:

weights

Danh sách giá trị được phân tách bằng dấu cách, xác định tỷ lệ của cung tròn được chiếm theo từng trọng số, ví dụ: 1.0 2.0 3.0, trong đó phần tử thứ ba chiếm 3 lần góc của phần tử thứ nhất.

Khi được dùng để biểu thị dữ liệu trong chức năng WEIGHTED_ELEMENTS, Có thể truyền trực tiếp [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS].

discreteGap

Góc giữa mỗi phần tử. Giá trị mặc định là 0.0.

interpolate

Khi đặt thành true, mỗi phần tử N trong danh sách weights đều có một màu chuyển màu từ màu N sang màu N+1 của danh sách colors, ngược lại với màu đồng nhất.

Khi được dùng để biểu thị dữ liệu từ GOAL_PROGRESS hoặc RANGED_VALUE chức năng, bạn có thể chuyển giá trị cho [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] hoặc Trực tiếp [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE]. Khi dùng trong biểu thị dữ liệu chức năng WEIGHTED_ELEMENTS, hãy đặt interpolate thành false.

Giá trị mặc định là false.

cap

Xác định hình dạng cạnh của nét vẽ. Sau đây là các giá trị được hỗ trợ:

  • BUTT làm cho nét vẽ kết thúc cùng với đường và không tràn ra ngoài đường đó.
  • ROUND khiến nét vẽ nhô ra dưới dạng hình bán nguyệt với tâm ở cuối đường.
  • SQUARE làm cho nét vẽ có dạng hình vuông, với tâm nằm ở cuối đường dẫn.

Phần tử bên trong

Phần tử WeightedStroke có thể chứa các phần tử sau: