本页面详细介绍了 CarUiListItem 列表项的自定义选项。
使用 Car UI 库显示项目列表的公认范例是结合使用 CarUiRecyclerView、CarUiListItemAdapter 和 CarUiListItem 对象。CarUiRecyclerView 自定义在 caruirecyclerview 中介绍。
前提条件
以下内容假定您了解自定义应用中描述的运行时资源叠加层 (RRO)。
关于 CarUiListItem
列表项可以是两种高级类型之一：标头或内容。每种类型将在下面介绍。
标头
CarUiListItemAdapter 将 CarUiHeaderListItem 类型的对象绑定到从 car_ui_header_list_item 布局文件扩充的视图，该文件包含以下视图
| 视图 | |
|---|---|
title |
标题 TextView |
body |
正文 TextView |
例如，下面的标头列表项配置为显示标题和正文文本
内容
CarUiListItemAdapter 将 CarUiHeaderListItem 类型的对象绑定到从 car_ui_list_item 布局文件扩充的视图。此文件包含以下视图
| 视图 | |
|---|---|
icon_container |
主图标的容器 |
title |
标题 TextView |
body |
正文 TextView |
action_container |
操作视图的容器 |
例如，下面的内容列表项配置为显示图标和开关
图标
根据为列表项配置的图标类型，以下三个视图之一用于主图标
| 视图 | |
|---|---|
icon |
标准图标 ImageView |
content_icon |
内容图标 ImageView |
avatar_icon |
头像图标 ImageView |
操作元素
最多显示以下操作元素视图之一，具体取决于列表项的操作类型
| 视图 | |
|---|---|
switch_widget |
开关 |
checkbox_widget |
复选框 |
radio_button_widget |
单选按钮 |
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 尺寸值定义。叠加此尺寸值可更改补充图标的大小。