यह पृष्ठ CarUiListItem सूची आइटम के लिए अनुकूलन विकल्पों का विवरण देता है।
वस्तुओं की सूची प्रदर्शित करने के लिए कार यूआई लाइब्रेरी का उपयोग करने के लिए स्वीकृत प्रतिमान CarUiListItemAdapter और CarUiListItem ऑब्जेक्ट के संयोजन में CarUiRecyclerView का उपयोग करना है। CarUiRecyclerView अनुकूलन caruirecyclerview में शामिल है।
आवश्यक शर्तें
निम्नलिखित सामग्री कस्टमाइज़ ऐप्स में वर्णित रनटाइम रिसोर्स ओवरले (आरआरओ) की समझ का अनुमान लगाती है।
CarUiListItem के बारे में
सूची आइटम दो उच्च-स्तरीय प्रकारों में से एक हो सकते हैं, हेडर या सामग्री । प्रत्येक का वर्णन नीचे दिया गया है।
हैडर
CarUiListItemAdapter CarUiHeaderListItem प्रकार की वस्तुओं को car_ui_header_list_item लेआउट फ़ाइल से फुलाए गए दृश्य से जोड़ता है, जिसमें ये दृश्य शामिल हैं:
| दृश्य | |
|---|---|
title | शीर्षक टेक्स्टव्यू |
body | बॉडी टेक्स्ट व्यू |
उदाहरण के लिए, नीचे दिए गए हेडर सूची आइटम को शीर्षक और मुख्य पाठ प्रदर्शित करने के लिए कॉन्फ़िगर किया गया है:
सामग्री
CarUiListItemAdapter CarUiHeaderListItem प्रकार की वस्तुओं को car_ui_list_item लेआउट फ़ाइल से फुलाए गए दृश्य से जोड़ता है। इस फ़ाइल में ये दृश्य हैं:
| दृश्य | |
|---|---|
icon_container | प्राथमिक चिह्न के लिए कंटेनर |
title | शीर्षक टेक्स्टव्यू |
body | बॉडी टेक्स्ट व्यू |
action_container | क्रिया दृश्य के लिए कंटेनर |
उदाहरण के लिए, नीचे दी गई सामग्री सूची आइटम को एक आइकन और एक स्विच प्रदर्शित करने के लिए कॉन्फ़िगर किया गया था:
माउस
सूची आइटम के लिए कॉन्फ़िगर किए गए आइकन प्रकार के आधार पर, प्राथमिक आइकन के लिए निम्नलिखित तीन दृश्यों में से एक का उपयोग किया जाता है:
| दृश्य | |
|---|---|
icon | मानक चिह्न छवि दृश्य |
content_icon | सामग्री आइकन छवि दृश्य |
avatar_icon | अवतार आइकन छवि दृश्य |
क्रिया तत्व
सूची आइटम के लिए क्रिया प्रकार के आधार पर, अधिक से अधिक निम्नलिखित क्रिया तत्व दृश्यों में से एक प्रदर्शित किया जाता है:
| दृश्य | |
|---|---|
switch_widget | Switch |
checkbox_widget | CheckBox |
radio_button_widget | RadioButton |
supplemental_icon | ImageView |
पाठ को अनुकूलित करें
हेडर और सामग्री सूची आइटम दोनों में टेक्स्ट स्टाइलिंग को कार यूआई लाइब्रेरी में परिभाषित टेक्स्ट उपस्थिति शैलियों द्वारा नियंत्रित किया जाता है। सूची आइटमों की टेक्स्ट शैली को ओवरराइड करने के लिए, नीचे सूचीबद्ध संबंधित शैलियों को ओवरराइड करें।
हेडर शैलियों को अनुकूलित करने के लिए:
| शीर्षलेख शैलियाँ | |
|---|---|
| शीर्षक पाठ | @style/TextAppearance.CarUi.ListItem |
| मुख्य भाग | @style/TextAppearance.CarUi.ListItem.Body |
सामग्री शैलियों को अनुकूलित करने के लिए:
| सामग्री शैलियाँ | |
|---|---|
| शीर्षक पाठ | @style/TextAppearance.CarUi.ListItem.Header |
| मुख्य भाग | @style/TextAppearance.CarUi.ListItem.Body |
चिह्न अनुकूलित करें
सामग्री सूची आइटम में प्राथमिक और पूरक दोनों आइकन हो सकते हैं।
प्राथमिक चिह्न
यद्यपि सामग्री सूची आइटम लेआउट में आइकन कंटेनर के भीतर तीन ImageView ऑब्जेक्ट परिभाषित हैं, सूची आइटम के निर्दिष्ट आइकन प्रकार के आधार पर अधिकतम एक आइकन प्रदर्शित किया जाता है। आइटम बाइंड समय पर, CarUiListItemAdapter आइकन ImageView ऑब्जेक्ट के लिए उचित दृश्यता सेट करता है।
आइकन की चौड़ाई और ऊंचाई को आयाम मानों द्वारा नियंत्रित किया जाता है जिन्हें आकार को नियंत्रित करने के लिए ओवरलैड किया जा सकता है। विभिन्न आइकन प्रकारों के लिए चौड़ाई और ऊंचाई निर्दिष्ट करने वाले आयाम मान नीचे सूचीबद्ध हैं।
मानक चिह्न
डिफ़ॉल्ट रूप से, मानक आइकन की ऊंचाई और चौड़ाई समान होती है।
| मानक चिह्न | |
|---|---|
| चौड़ाई | car_ui_list_item_icon_size |
| ऊंचाई | car_ui_list_item_icon_size |
सामग्री चिह्न
| सामग्री चिह्न | |
|---|---|
| चौड़ाई | car_ui_list_item_content_icon_width |
| ऊंचाई | car_ui_list_item_content_icon_height |
अवतार चिह्न
डिफ़ॉल्ट रूप से, प्राथमिक आइकन आइकन कंटेनर दृश्य के भीतर केंद्रित होते हैं, जिसकी चौड़ाई car_ui_list_item_icon_container_width आयाम मान द्वारा परिभाषित होती है।
| अवतार चिह्न | |
|---|---|
| चौड़ाई | car_ui_list_item_content_icon_width |
| ऊंचाई | car_ui_list_item_content_icon_height |
पूरक चिह्न
पूरक आइकन एक्शन कंटेनर दृश्य के भीतर केंद्रित है। पूरक आइकन की चौड़ाई और ऊंचाई दोनों को car_ui_list_item_supplemental_icon_size आयाम मान द्वारा परिभाषित किया गया है। पूरक आइकन का आकार बदलने के लिए इस आयाम मान को ओवरले करें।