Line
Vẽ một đường thẳng giữa hai điểm cuối trong tọa độ cục bộ. Thích hợp cho các đường chỉ báo, dấu tích và dải phân cách, bạn có thể đặt kiểu màu, chiều rộng, dấu gạch ngang và điểm cuối.
Ví dụ
function main() {
return (
<Line
start={{ x: 0, y: 20 }}
end={{ x: 160, y: 60 }}
stroke={$env.accent}
lineWidth={4}
lineCap="round"
/>
);
}
Cách sử dụng
- start/end là điểm cục bộ: gốc trên trái, x sang phải, y xuống. Không tự co theo width/height; hãy tính theo kích thước. Line không có vùng trong để tô.
- x/y và transform áp dụng sau bố cục. Dời con không đẩy các con khác; dùng spacing hoặc Spacer. Xoay và tỷ lệ tác động lên toàn bộ hình đã vẽ.
Thuộc tính
start?ViewPointĐiểm cuối tọa độ cục bộ theo điểm: x sang phải, y xuống.
{x: 0, y: 0}end?ViewPointĐiểm cuối tọa độ cục bộ theo điểm: x sang phải, y xuống.
{x: 100, y: 80}stroke?PaintMàu hoặc chuyển màu của nét; clear ẩn nét.
HDR($env.dark ? "white" : "black")lineWidth?numberĐộ dày nét theo điểm; 0 không vẽ nét.
2lineCap?"round" | "butt" | "square"Đầu nét: butt cắt tại điểm, square kéo dài vuông, round bo tròn.
"round"dash?number[]Độ dài nét và khoảng trống xen kẽ theo điểm; mảng rỗng là nét liền.
[]dashPhase?numberĐộ dịch mẫu nét đứt theo điểm.
0trimStart?numberĐoạn đường hiện trimStart–trimEnd trong 0–1. Circle/Ellipse/Arc dùng góc.
0trimEnd?numberĐoạn đường hiện trimStart–trimEnd trong 0–1. Circle/Ellipse/Arc dùng góc.
1Thuộc tính chung
width?number | "auto" | "fill"Chiều rộng tính bằng point, tự động hoặc lấp đầy khung cha.
"fill"height?number | "auto" | "fill"Chiều cao tính bằng point, tự động hoặc lấp đầy khung cha.
"fill"x?numberDịch chuyển hiển thị theo điểm: x sang phải, y xuống dưới; không đổi chỗ trong bố cục.
0y?numberDịch chuyển hiển thị theo điểm: x sang phải, y xuống dưới; không đổi chỗ trong bố cục.
0transform?ViewTransformBiến đổi toàn View không đổi bố cục. Dịch chuyển theo điểm, xoay/nghiêng theo độ, tỷ lệ 1 giữ nguyên, điểm neo 0–1.
{rotation: 0}opacity?numberĐộ đục toàn bộ View: 0 trong suốt, 1 đục hoàn toàn.
1clipped?booleanCắt phần vẽ vượt ra ngoài View.
falseclip?"rectangle" | "ellipse"Hình cắt rectangle hoặc ellipse; Material còn nhận false để tắt.
"rectangle"mask?View | nullView mặt nạ alpha. Căn giữa mà không ảnh hưởng bố cục; null tắt mặt nạ.
<Circle width="fill" height="fill" background="white"/>zIndex?numberThứ tự vẽ giữa các phần tử cùng cấp; giá trị lớn nằm trước.
0blur?numberBán kính làm mờ theo điểm; 0 là tắt.
4innerShadow?DrawingEffectMàu, độ đục, bán kính mờ và độ lệch x/y của hiệu ứng; khoảng cách theo điểm.
{color: HDR("black"), opacity: 0.5, radius: 4, x: 0, y: 2}glow?DrawingEffectMàu, độ đục, bán kính mờ và độ lệch x/y của hiệu ứng; khoảng cách theo điểm.
{color: HDR("cyan"), radius: 8, opacity: 0.8}shadowColor?ColorMàu bóng đổ bên ngoài.
HDR("black")shadowOpacity?numberĐộ đục bóng 0–1; 0 ẩn bóng.
0shadowRadius?numberBán kính làm mờ bóng ngoài theo điểm.
4shadowX?numberĐộ lệch bóng theo điểm: x sang phải, y xuống.
0shadowY?numberĐộ lệch bóng theo điểm: x sang phải, y xuống.
2animations?Animation[]Hoạt ảnh khi thuộc tính đổi. duration/delay theo giây; from/to là đầu cuối; repeat/autoreverse điều khiển lặp, wrap là chu kỳ.
[{property: "opacity", duration: 0.25, curve: "easeInOut"}]key?string | numberĐịnh danh ổn định giữa các phần tử cùng cấp.
Ví dụ kết hợp
function main() {
return (
<Line
width={$env.width}
height={40}
start={{ x: 0, y: 20 }}
end={{ x: $env.width, y: 20 }}
stroke={$env.accent}
lineWidth={3}
dash={[8, 4]}
dashPhase={0}
/>
);
}
Hoạt ảnh
widthheightxyopacityblurshadowColorshadowOpacityshadowRadiusshadowXshadowYtrimStarttrimEnddashPhasestrokelineWidthtransform.translateXtransform.translateYtransform.scaleXtransform.scaleYtransform.rotationtransform.skewXtransform.skewYtransform.anchorXtransform.anchorYstart.xstart.yend.xend.yKhi bỏ qua
Bảng ghi hành vi bỏ qua đã kiểm tra từ triển khai; ví dụ không phải mặc định. Muốn kết quả cố định hãy truyền giá trị rõ, kích thước và màu theo ngữ cảnh không phải hằng số.
| Thuộc tính | Khi bỏ qua |
|---|---|
lineWidth | 2 |
lineCap | "round" |
trimStart | 0 |
trimEnd | 1 |
dash | [] |
dashPhase | 0 |
stroke | HDR($env.dark ? 'white' : 'black') |