此页面详细介绍了CarUiListItem列表项的自定义选项。
使用 Car UI 库显示项目列表的公认范例是将CarUiRecyclerView与CarUiListItemAdapter和CarUiListItem对象结合使用。 CarUiRecyclerView自定义包含在caruirecyclerview中。
先决条件
以下内容假定您了解自定义应用程序中描述的运行时资源覆盖 (RRO)。
关于 CarUiListItem
列表项可以是两种高级类型之一： header或content 。下面对每一个进行描述。
标头
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 | 内容图标 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尺寸值定义。覆盖此尺寸值以更改补充图标的大小。