الحِزم العمودية في Jetpack Compose Glimmer

أجهزة XR المشمولة
تساعدك هذه الإرشادات في إنشاء تجارب لهذه الأنواع من أجهزة XR.
مزيد من المعلومات حول أنواع أجهزة XR →
نظارات العرض
مزيد من المعلومات حول أنواع أجهزة XR →

في Jetpack Compose Glimmer، يكون VerticalStack تنسيقًا كسولاً قابلاً للتمرير عموديًا يرتب العناصر في تسلسل ثلاثي الأبعاد متراكب مرئيًا. يتم عرض العنصر الأساسي بشكل بارز في المقدّمة، بينما يتم وضع العناصر اللاحقة خلفه.

الشكل 1. مثال على بعض الأنماط المختلفة للمجموعات في Jetpack Compose Glimmer

سلوكيات التمرير والتمركز

بما أنّ المجموعات تحافظ على ترتيب العناصر في تنسيق مضغوط ومتراكب، فإنّها تتضمّن بعض السلوكيات المختلفة عن الأنواع الأخرى من المكوّنات المتسلسلة، مثل القوائم:

  • عندما يمرّر المستخدم عموديًا، ينتقل العنصر النشط في المقدّمة خارج العرض، ما يسمح للعنصر الموجود أسفله مباشرةً بالانزلاق إلى موضع المقدّمة البارز.
  • يتم دائمًا تحريك العناصر باستخدام تحريك ارتدادي متخصص إلى موضع المقدّمة بعد انتهاء إيماءة المستخدم.
  • يتم وضع العناصر على طول المحور z، مع وضع العناصر الأبعد في القائمة خلف العنصر الأساسي.

إدارة التركيز

يستخدم VerticalStack نظام تركيز متخصصًا لضمان أنّ العنصر الحالي في المقدّمة هو دائمًا الهدف الأساسي لتفاعل المستخدم:

  • التركيز الأوّلي وإعادة التركيز: ينتقل التركيز الأوّلي وإعادة التركيز إلى العنصر العلوي الحالي في المجموعة.
  • إشعار التركيز التلقائي: أثناء انتقال العناصر، تطلب المجموعة التركيز على العنصر العلوي.
  • تتبُّع التركيز: يستخدم كل عنصر onFocusChanged لإعلام StackState بحالة التركيز الفردية.

مثال: إنشاء مجموعة عمودية

تنشئ التعليمة البرمجية التالية مجموعة عمودية تتضمّن بعض عناصر البطاقات:

@Composable
fun VerticalStackSample() {
    VerticalStack {
        item {
            Card { Text("Top Card") }
        }
        item {
            Card { Text("Second Card") }
        }
        item {
            Card { Text("Third Card") }
        }
    }
}