На этой странице подробно описаны параметры настройки элементов списка CarUiListItem .
Принятой парадигмой использования библиотеки пользовательского интерфейса автомобиля для отображения списка элементов является использование 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 | Стандартный значок ImageView |
content_icon | Значок содержимого |
avatar_icon | Значок аватара ImageView |
Элементы действия
В зависимости от типа действия для элемента списка отображается не более одного из следующих представлений элемента действия:
| Просмотры | |
|---|---|
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 . Наложите это значение размера, чтобы изменить размер дополнительного значка.