تعرض هذه الصفحة تفاصيل خيارات التخصيص لعناصر قائمة CarUiListItem .
النموذج المقبول لاستخدام مكتبة Car UI لعرض قائمة العناصر هو استخدام CarUiRecyclerView بالتزامن مع كائنات CarUiListItemAdapter و CarUiListItem . تمت تغطية تخصيص CarUiRecyclerView في caruirecyclerview .
المتطلبات الأساسية
يفترض المحتوى التالي فهمًا لتراكبات موارد وقت التشغيل (RRO) الموضحة في تخصيص التطبيقات .
حول 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 | أيقونة الصورة الرمزية ImageView |
عناصر العمل
على الأكثر، يتم عرض إحدى طرق عرض عناصر الإجراء التالية، استنادًا إلى نوع الإجراء الخاص بعنصر القائمة:
| الآراء | |
|---|---|
switch_widget | Switch |
checkbox_widget | CheckBox |
radio_button_widget | RadioButton |
supplemental_icon | ImageView |
تخصيص النص
يتم التحكم في تصميم النص في كل من عناصر قائمة الرأس والمحتوى من خلال أنماط مظاهر النص المحددة في مكتبة Car UI. لتجاوز نمط النص لعناصر القائمة، قم بتجاوز الأنماط المقابلة المدرجة أدناه.
لتخصيص أنماط الرأس :
| أنماط الرأس | |
|---|---|
| نص العنوان | @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 . قم بتراكب قيمة البعد هذه لتغيير حجم الأيقونة الإضافية.