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

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

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

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

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

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

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

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

مثال: عنصر قائمة أساسي

تنشئ التعليمة البرمجية التالية عنصر قائمة أساسيًا:

@Composable
fun ListItemSample() {
    ListItem { Text("This is a list item") }
}

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

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

@Composable
fun ListItemWithIconsSample() {
    ListItem(
        leadingIcon = { Icon(FavoriteIcon, contentDescription = "Favorite") },
        trailingIcon = { Icon(FavoriteIcon, contentDescription = "Favorite") }
    ) {
        Text("This is a list item with icons")
    }
}