Tập tạ

Kể từ phiên bản 2

Mẫu nét vẽ có các phân đoạn riêng lẻ, có thể có trọng số và màu sắc đã chỉ định. Đặc biệt sử dụng để hiển thị các chức năng GOAL_PROGRESS, RANGED_VALUE và WEIGHTED_ELEMENTS.

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 từng phần tử của nét vẽ có trọng số, dưới dạng một danh sách các giá trị hex được phân tách bằng dấu cách, ví dụ: #FF0000 #00FF00 #0000FF.

Khi 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, bạn có thể điền trực tiếp colors bằng [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ệ vòng cung được lấy bởi mỗi 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ử đầu tiên.

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

discreteGap

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

interpolate

Khi được đặt thành true, mỗi phần tử N trong danh sách weights sẽ có độ dốc màu từ màu N sang màu N+1 của danh sách colors, thay vì một màu đồng nhất.

Khi được dùng để biểu thị dữ liệu từ chức năng GOAL_PROGRESS hoặc RANGED_VALUE, bạn có thể truyền trực tiếp các giá trị cho các trường [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] hoặc [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE]. Khi được dùng để 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: