Jetpack Compose Glimmer में, ListItem कॉन्टेंट की एक लाइन दिखाने के लिए स्टैंडर्ड कॉम्पोनेंट है. लिस्ट आइटम को डिसप्ले ग्लास के फ़ोकस-आधारित इंटरैक्शन के लिए डिज़ाइन किया गया है. इसलिए, फ़ोकस किए जाने पर वे विज़ुअल जवाब देते हैं.
इस कॉम्पोनेंट में दो ओवरलोड होते हैं: एक में onClick पैरामीटर होता है. इसका इस्तेमाल उन आइटम के लिए किया जाता है जो कार्रवाइयों को ट्रिगर करते हैं. दूसरा, सिर्फ़ फ़ोकस किए जा सकने वाला वर्शन होता है. इसका इस्तेमाल ऐसी जानकारी वाले कॉन्टेंट के लिए किया जाता है जिसके लिए क्लिक करने की ज़रूरत नहीं होती.
सूचियों में इस्तेमाल
सूची में मौजूद लाइनों के लिए, सूची वाले आइटम मुख्य विकल्प होते हैं. हालांकि, सूचियों में अन्य कॉम्पोनेंट भी शामिल किए जा सकते हैं. जैसे, 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") } }