CapDriveCircle
在可用區域內繪製正圓或圓弧，適合環形進度和儀表刻度。直徑取寬高中的較小值，startAngle 與 sweepAngle 控制顯示範圍，整圈閉合時可填充背景。
範例
function main() {
return (
<Circle
width={120}
height={120}
background="clear"
stroke={$env.accent}
lineWidth={8}
startAngle={-90}
sweepAngle={240}
strokePosition="inside"
/>
);
}
使用說明
- Circle 用寬高中較小的一邊畫置中的正圓，160×100 得到直徑 100。startAngle/sweepAngle 改輪廓範圍，transform 改整體結果。
- 角度用度：0 向右、90 向下、正 sweep 順時針。startAngle 以 360 歸一化，sweepAngle 限 −360…360 並保留方向；0 不畫，±360 整圈。startAngle 可用 wrap:360，sweepAngle 不可。
- Ellipse 和 Arc 使用完整寬高作橢圓邊界，寬高相同才是圓。部分圓弧保持開放，不連回圓心成扇形；background 僅完整閉合一圈時填色。
屬性
startAngle?number起始角度，單位為度；取樣時按 360° 取模。
0sweepAngle?number掃角，單位為度；取樣時限制在 -360…360。正值為順時針，不支援 wrap。
360background?Paint完整封閉圓或橢圓的填滿筆刷。部分弧線不繪製填滿。
HDR($env.dark ? "white" : "black")stroke?Paint描邊可用顏色或漸層；clear 隱藏描邊。
"clear"lineWidth?number描邊寬度，單位為點；0 不繪製。
2strokePosition?"inside" | "center" | "outside"描邊相對於完整圓或橢圓輪廓的位置，預設為 inside。
"inside"lineCap?"round" | "butt" | "square"線端：butt 截斷、square 延伸方頭、round 圓頭。
"round"dash?number[]交替實線及空白的長度，單位為點；空陣列為實線。
[]dashPhase?number虛線樣式沿路徑的位移，單位為點。
0通用屬性
width?number | "auto" | "fill"寬度：點數、自動測量或填滿父區域。
"fill"height?number | "auto" | "fill"高度：點數、自動測量或填滿父區域。
"fill"x?number視覺位移，單位為點：x 向右、y 向下，不改變版面佔位。
0y?number視覺位移，單位為點：x 向右、y 向下，不改變版面佔位。
0transform?ViewTransform整體視覺變換不改變版面。平移用點，旋轉及傾斜用度，縮放 1 不變，錨點用 0–1。
{rotation: 0}opacity?number整個 View 的不透明度：0 完全透明，1 完全不透明。
1clipped?boolean是否裁切超出 View 邊界的內容。
falseclip?"rectangle" | "ellipse"裁切形狀：rectangle 矩形或 ellipse 橢圓；Material 另可用 false 停用。
"rectangle"mask?View | null透明度遮罩 View，置中顯示且不影響佈局；null 表示不使用遮罩。
<Circle width="fill" height="fill" background="white"/>zIndex?number同層 View 的繪製順序，數值越大越靠前。
0blur?number模糊半徑，單位為點；0 不模糊。
4innerShadow?DrawingEffect特效的顏色、不透明度、模糊半徑及 x/y 位移；距離用點。
{color: HDR("black"), opacity: 0.5, radius: 4, x: 0, y: 2}glow?DrawingEffect特效的顏色、不透明度、模糊半徑及 x/y 位移；距離用點。
{color: HDR("cyan"), radius: 8, opacity: 0.8}shadowColor?Color外部陰影顏色。
HDR("black")shadowOpacity?number外部陰影不透明度 0–1；0 隱藏陰影。
0shadowRadius?number外部陰影模糊半徑，單位為點。
4shadowX?number外部陰影位移，單位為點：x 向右、y 向下。
0shadowY?number外部陰影位移，單位為點：x 向右、y 向下。
2animations?CircleAnimation[]屬性改變時播放動畫。duration/delay 用秒，from/to 設端點，repeat/autoreverse 控制重複，wrap 設週期。
[{property: "opacity", duration: 0.25, curve: "easeInOut"}]key?string | number兄弟節點中的穩定識別碼。
組合範例
function main() {
return (
<ZStack width={140} height={140}>
<Circle
width="fill"
height="fill"
background="clear"
stroke="#88888833"
lineWidth={10}
/>
<Circle
width="fill"
height="fill"
background="clear"
stroke={$env.accent}
lineWidth={10}
startAngle={-90}
sweepAngle={270}
lineCap="round"
/>
<Text fontSize={36}>75%</Text>
</ZStack>
);
}
動畫
widthheightxyopacitybackgroundblurshadowColorshadowOpacityshadowRadiusshadowXshadowYdashPhasestrokelineWidthstartAnglesweepAngletransform.translateXtransform.translateYtransform.scaleXtransform.scaleYtransform.rotationtransform.skewXtransform.skewYtransform.anchorXtransform.anchorY省略時的行為
下表是經實作核對的省略行為；屬性範例不是預設值。固定效果應明確傳值，尺寸和主題色等依環境變動，不能視為常數。
| 屬性 | 省略時的行為 |
|---|---|
startAngle | 0 |
sweepAngle | 360 |
lineWidth | 2 |
strokePosition | "inside" |
background | HDR($env.dark ? 'white' : 'black') |