Arc

ارسم قوسًا بيضاويًا وفقًا لزاوية البداية والزاوية الشاملة، وهو مناسب لأقواس المقياس وعرض التقدم. يتم تحديد الحدود حسب العرض والارتفاع. يمكن تكوين العرض ونقطة النهاية وموضع الحد، ويُسمح للخلفية بالملء عند إغلاقها بالكامل.

مثال

function main() {
  return (
    <Arc
      width={120}
      height={120}
      startAngle={-90}
      sweepAngle={240}
      stroke={$env.accent}
      lineWidth={8}
      lineCap="round"
      strokePosition="center"
    />
  );
}

الاستخدام

Ellipse وArc يستخدمان العرض والارتفاع كاملين؛ تساويهما يعطي دائرة. القوس الجزئي مفتوح ولا يتصل بالمركز. background يملأ دورة كاملة مغلقة فقط.
الزاوية بالدرجات: 0 يمينًا، 90 للأسفل، sweep الموجب مع الساعة. startAngle بترديد 360 وsweepAngle بين −360…360. صفر لا يرسم و±360 دورة. wrap:360 لـ startAngle فقط.
background/stroke يقبلان Color أو Gradient. استخدم دوال Gradient الثلاث: المواقع والمراكز 0–1، وأنصاف الأقطار بالنقاط. HDR يغلف لونًا واحدًا وسطوعه يعتمد على الجهاز والعرض.

الخصائص

startAngle?number

زاوية البداية بالدرجات، تُطبّع بترديد 360 عند أخذ العينات.

مثال-90

sweepAngle?number

زاوية المسح بالدرجات، تُحصر بين -360…360 عند أخذ العينات. القيم الموجبة مع عقارب الساعة؛ wrap غير مدعوم.

مثال270

background?Paint

تعبئة دائرة أو قطع ناقص كامل ومغلق. تُتجاهل للأقواس الجزئية.

مثال"clear"

stroke?Paint

لون أو تدرج للخط؛ clear يخفيه.

مثالHDR($env.dark ? "white" : "black")

lineWidth?number

سماكة الخط بالنقاط؛ 0 لا يرسم خطاً.

مثال2

strokePosition?"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 لأسفل، دون تغيير المساحة في التخطيط.

مثال0

y?number

إزاحة بصرية بالنقاط: x يميناً وy لأسفل، دون تغيير المساحة في التخطيط.

مثال0

transform?ViewTransform

تحويل View كله دون تغيير التخطيط. الإزاحة بالنقاط، الدوران والميل بالدرجات، المقياس 1 بلا تغيير، والمرساة 0–1.

مثال{rotation: 0}

opacity?number

عتامة View بالكامل: 0 شفاف و1 معتم.

مثال1

clipped?boolean

قص الرسم الذي يتجاوز حدود View.

مثالfalse

clip?"rectangle" | "ellipse"

شكل القص rectangle أو ellipse؛ يقبل Material أيضاً false لتعطيله.

مثال"rectangle"

mask?View | null

عرض قناع ألفا. يتم توسيطه دون التأثير على التخطيط؛ تعطل null القناع.

مثال<Circle width="fill" height="fill" background="white"/>

zIndex?number

ترتيب الرسم بين العناصر الشقيقة؛ القيم الأكبر في الأمام.

مثال0

blur?number

نصف قطر التمويه بالنقاط؛ 0 يعطّله.

مثال4

innerShadow?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 يخفيه.

مثال0

shadowRadius?number

نصف قطر تمويه الظل الخارجي بالنقاط.

مثال4

shadowX?number

إزاحة الظل بالنقاط: x يميناً وy لأسفل.

مثال0

shadowY?number

إزاحة الظل بالنقاط: x يميناً وy لأسفل.

مثال2

animations?ArcAnimation[]

تحريك تغير الخاصية. duration/delay بالثواني، from/to للنهايات، repeat/autoreverse للتكرار وwrap للدورة.

مثال[{property: "opacity", duration: 0.25, curve: "easeInOut"}]

key?string | number

معرّف ثابت بين العناصر الشقيقة.

مثال عملي

function main() {
  return (
    <Arc
      width={180}
      height={100}
      startAngle={180}
      sweepAngle={180}
      background="clear"
      stroke={LinearGradient(['#30B3A2', '#A9E56F'])}
      lineWidth={8}
      strokePosition="inside"
      lineCap="round"
    />
  );
}

الحركة

widthheightxyopacitybackgroundblurshadowColorshadowOpacityshadowRadiusshadowXshadowYdashPhasestrokelineWidthstartAnglesweepAngletransform.translateXtransform.translateYtransform.scaleXtransform.scaleYtransform.rotationtransform.skewXtransform.skewYtransform.anchorXtransform.anchorY

عند الإغفال

الجدول يوضح سلوك الإغفال المتحقق من التنفيذ؛ الأمثلة ليست افتراضيات. لنتيجة ثابتة مرر قيمة صريحة؛ الأبعاد وألوان الثيم متغيرة بحسب السياق.

الخصائص	عند الإغفال
`startAngle`	`-90`
`sweepAngle`	`270`
`lineWidth`	`2`
`strokePosition`	`"inside"`
`background`	`"clear"`
`stroke`	`HDR($env.dark ? 'white' : 'black')`

مثال

الاستخدام

الخصائص

مثال عملي

الحركة

عند الإغفال

Circle

Ellipse

RadialLayout

Color / Gradient

في هذه الصفحة

Arc

مثال

الاستخدام

الخصائص

مثال عملي

الحركة

عند الإغفال

واجهات مرتبطة

Circle

Ellipse

RadialLayout

Color / Gradient

في هذه الصفحة