В этой статье подробно описаны параметры настройки для элементов списка CarUiListItem .
Принятая парадигма использования библиотеки автомобильного пользовательского интерфейса для отображения списка элементов заключается в использовании CarUiRecyclerView в сочетании с CarUiListItemAdapter и CarUiListItem . Настройка CarUiRecyclerView описана в caruirecyclerview .
Предпосылки
Следующее содержимое предполагает понимание наложений ресурсов времени выполнения (RRO), описанных в разделе « Настройка приложений ».
О CarUiListItem
Элементы списка могут относиться к одному из двух высокоуровневых типов: заголовку или содержимому . Каждый описан ниже.
Заголовок
CarUiListItemAdapter привязывает объекты типа CarUiHeaderListItem к представлению, созданному из файла макета car_ui_header_list_item , который содержит следующие представления:
| Просмотры | |
|---|---|
title | Заголовок TextView. |
body | Просмотр основного текста. |
Например, элемент списка заголовков ниже настроен для отображения заголовка и основного текста:
Содержание
CarUiListItemAdapter привязывает объекты типа CarUiHeaderListItem к представлению, созданному из файла макета car_ui_list_item . Этот файл содержит следующие представления:
| Просмотры | |
|---|---|
icon_container | Контейнер для основного значка. |
title | Заголовок TextView. |
body | Просмотр основного текста. |
action_container | Контейнер для просмотра действий. |
Например, элемент списка содержимого ниже был настроен для отображения значка и переключателя:
Иконки
В зависимости от типа значка, настроенного для элемента списка, для основного значка используется одно из следующих трех представлений:
| Просмотры | |
|---|---|
icon | Стандартная иконка ImageView. |
content_icon | Значок содержимого ImageView. |
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 . Наложите это значение размера, чтобы изменить размер дополнительного значка.