عناصر القائمة في Glimmer من Jetpack Compose

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

في Jetpack Compose Glimmer، يكون ListItem هو المكوّن العادي لـ عرض صف واحد من المحتوى. تم تصميم عناصر القائمة للتفاعل المستند إلى التركيز في نظّارة العرض الذكية، لذا فهي توفّر استجابة مرئية مضمّنة عند التركيز عليها.

يحتوي المكوّن على حمولتَين زائدتَين: إحداهما تتضمّن مَعلمة onClick للعناصر التي تؤدي إلى إجراءات، والأخرى قابلة للتركيز فقط لعرض المحتوى المعلوماتي الذي لا يتطلّب إجراء نقرة.

الشكل 1. مثال على قائمتَين تتضمّنان أنماطًا مختلفة من عناصر القائمة في Jetpack Compose Glimmer

الاستخدام ضِمن القوائم

تُعدّ عناصر القائمة الخيار الأساسي للصفوف ضِمن الـ قائمة، ولكن يمكن أن تستضيف القوائم أيضًا مكوّنات أخرى، مثل Card أو TitleChip، لتوفير تركيز مرئي مختلف.

تستخدِم عناصر القائمة موضع العرض headlineContent للنص الأساسي الخاص بها ليتطابق مع مكوّنات Card وTitleChip المستخدَمة لعناصر أخرى.

مثال: عنصر قائمة يتضمّن تصنيفًا ثانويًا ورموزًا

تنشئ التعليمة البرمجية التالية عنصر قائمة يتضمّن تصنيفًا ثانويًا ورموزًا في المقدّمة والمؤخّرة:

@Composable
private fun ListItemWithSupportingLabelAndIcons() {
    ListItem(
        supportingLabel = { Text("Supporting Label") },
        leadingIcon = { Icon(FavoriteIcon, "Localized description") },
        trailingIcon = { Icon(FavoriteIcon, "Localized description") },
    ) {
        Text("Primary Label")
    }
}