Tập tạ

Kể từ phiên bản 2

Một mẫu nét vẽ với các đoạn riêng lẻ, có thể có độ đậm và màu sắc được chỉ định. Đặc biệt hữu ích khi kết xuất 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 được dùng để hiển thị 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 này có thể biến đổi.

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 đến 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 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: