این صفحه جزئیات گزینه های سفارشی سازی موارد لیست CarUiListItem را شرح می دهد.
الگوی پذیرفته شده برای استفاده از کتابخانه Car UI برای نمایش لیستی از موارد، استفاده از CarUiRecyclerView در ارتباط با CarUiListItemAdapter و اشیاء CarUiListItem است. سفارشی سازی CarUiRecyclerView در caruirecyclerview پوشش داده شده است.
پیش نیازها
محتوای زیر درک درستی از همپوشانی‌های منابع زمان اجرا (RRO) توصیف شده در سفارشی کردن برنامه‌ها را فرض می‌کند.
درباره CarUiListItem
موارد فهرست می توانند یکی از دو نوع سطح بالا، سرصفحه یا محتوا باشند. هر کدام در زیر توضیح داده شده است.
سرتیتر
CarUiListItemAdapter اشیایی از نوع CarUiHeaderListItem را به نمای پر شده از فایل طرح بندی car_ui_header_list_item متصل می کند که حاوی این نماها است:
| بازدیدها | |
|---|---|
title | عنوان TextView |
body | Body TextView |
به عنوان مثال، آیتم فهرست سرصفحه زیر برای نمایش عنوان و متن اصلی پیکربندی شده است:
محتوا
CarUiListItemAdapter اشیاء از نوع CarUiHeaderListItem را به نمای پرشده از فایل طرح بندی car_ui_list_item متصل می کند. این فایل حاوی این نماها است:
| بازدیدها | |
|---|---|
icon_container | ظرف برای نماد اصلی |
title | عنوان TextView |
body | Body TextView |
action_container | ظرفی برای نمای اکشن |
به عنوان مثال، آیتم فهرست محتوا در زیر برای نمایش یک نماد و یک سوئیچ پیکربندی شده است:
نمادها
بسته به نوع نماد پیکربندی شده برای آیتم لیست، یکی از سه نمای زیر برای نماد اصلی استفاده می شود:
| بازدیدها | |
|---|---|
icon | نماد استاندارد ImageView |
content_icon | نماد محتوا ImageView |
avatar_icon | نماد آواتار ImageView |
عناصر اقدام
حداکثر، یکی از نماهای عنصر اقدام زیر، بر اساس نوع اقدام برای آیتم فهرست نمایش داده می شود:
| بازدیدها | |
|---|---|
switch_widget | Switch |
checkbox_widget | CheckBox |
radio_button_widget | RadioButton |
supplemental_icon | ImageView |
سفارشی کردن متن
یک ظاهر طراحی شده متن در موارد فهرست محتوا و سرصفحه توسط سبک های ظاهر متنی که در کتابخانه UI Car تعریف شده اند کنترل می شود. برای نادیده گرفتن سبک نوشتاری آیتم های فهرست، سبک های مربوطه فهرست شده در زیر را نادیده بگیرید.
برای سفارشی کردن سبک های هدر :
| سبک های هدر | |
|---|---|
| متن عنوان | @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 تعریف می شود. برای تغییر اندازه نماد تکمیلی، این مقدار بعد را روی هم قرار دهید.