ZStack

قم بتجميع عدة View في نفس المنطقة، وهي مناسبة للقراءات الخلفية والمقياس والمركز. يتم رسم الأطفال View بشكل تسلسلي، ويقوم alignment بتعيين موضع المحاذاة المشترك الخاص بهم داخل الحاوية.

مثال

function main() {
  return (
    <ZStack alignment="center">
      <Circle width={100} height={100} background={$env.accent} />
      <Text color="black">78</Text>
    </ZStack>
  );
}

الاستخدام

يُرسم الأبناء من الخلف للأمام حسب الترتيب، ويغير zIndex ذلك. alignment يستخدم مرجع الحاوية نفسه؛ مع أبعاد متساوية يكون الفرق قليلًا.
الأبعاد الرقمية بالنقاط. auto يقيس المحتوى وfill يستخدم المساحة المخصصة من الأب. حدّد حجم الحاوية أولًا؛ fill والنص الطويل لا يوسّعان أبًا ثابتًا.
تُطبّق x/y وtransform بعد التخطيط. تحريك عنصر لا يدفع إخوته؛ استخدم spacing أو Spacer للفواصل. الدوران والتحجيم يؤثران في الرسم كاملًا.

الخصائص

children?ViewContent

محتوى الرسم الفرعي.

محاذاة العناصر المتراكبة إلى تسعة مواضع على الحواف والوسط.

مثال"center"

الخصائص المشتركة

width?number | "auto" | "fill"

العرض بالنقاط أو الحجم التلقائي أو ملء العنصر الأب.

مثال100

height?number | "auto" | "fill"

الارتفاع بالنقاط أو الحجم التلقائي أو ملء العنصر الأب.

مثال80

padding?number

المساحة الداخلية للمحتوى بالنقاط.

مثال0

x?number

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

مثال0

y?number

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

مثال0

transform?ViewTransform

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

مثال{rotation: 0}

background?Paint

لون أو تدرج للخلفية؛ clear يجعلها شفافة.

مثال"clear"

opacity?number

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

مثال1

cornerRadius?number

نصف قطر الزوايا بالنقاط.

مثال0

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?Animation[]

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

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

key?string | number

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

مثال عملي

function main() {
  return (
    <ZStack width={180} height={100} alignment="bottomTrailing">
      <Rectangle
        width="fill"
        height="fill"
        background="#30B3A233"
        cornerRadius={12}
      />
      <Text fontSize={40} x={-12} y={-8}>
        78
      </Text>
    </ZStack>
  );
}

الحركة

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

عند الإغفال

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

الخصائص	عند الإغفال
`alignment`	`"center"`

مثال

الاستخدام

الخصائص

مثال عملي

الحركة

عند الإغفال

Group

Material

في هذه الصفحة

ZStack

مثال

الاستخدام

الخصائص

مثال عملي

الحركة

عند الإغفال

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

Group

Material

في هذه الصفحة