CarUiListItem 的自定义选项

此页面详细介绍了CarUiListItem列表项的自定义选项。

使用 Car UI 库显示项目列表的公认范例是将CarUiRecyclerView与CarUiListItemAdapter和CarUiListItem对象结合使用。 CarUiRecyclerView自定义包含在caruirecyclerview中。

先决条件

以下内容假定您了解自定义应用程序中描述的运行时资源覆盖 (RRO)。

关于 CarUiListItem

列表项可以是两种高级类型之一： header或content 。下面对每一个进行描述。

标头

CarUiListItemAdapter将CarUiHeaderListItem类型的对象绑定到从car_ui_header_list_item布局文件扩展的视图，其中包含以下视图：

例如，下面的标题列表项配置为显示标题和正文文本：

内容

CarUiListItemAdapter将CarUiHeaderListItem类型的对象绑定到从car_ui_list_item布局文件扩展的视图。该文件包含以下视图：

例如，下面的内容列表项配置为显示图标和开关：

图标

根据为列表项配置的图标类型，以下三个视图之一用于主图标：

动作要素

根据列表项的操作类型，最多显示以下操作元素视图之一：

自定义文字

标题和内容列表项中的文本样式均由 Car UI 库中定义的文本外观样式控制。要覆盖列表项的文本样式，请覆盖下面列出的相应样式。

要自定义标题样式：

自定义内容样式：

自定义图标

内容列表项可以包含主图标和补充图标。

主图标

尽管内容列表项布局中的图标容器内定义了三个 ImageView 对象，但根据列表项指定的图标类型最多显示一个图标。在项目绑定时， CarUiListItemAdapter为图标 ImageView 对象设置适当的可见性。

图标的宽度和高度由尺寸值控制，可以叠加这些尺寸值来控制尺寸。下面列出了指定各种图标类型的宽度和高度的尺寸值。

标准图标

默认情况下，标准图标具有相同的高度和宽度。

内容图标

阿凡达图标

默认情况下，主图标位于图标容器视图的中心，其宽度由car_ui_list_item_icon_container_width维度值定义。

补充图标

补充图标位于操作容器视图的中心。补充图标的宽度和高度均由car_ui_list_item_supplemental_icon_size尺寸值定义。覆盖此尺寸值以更改补充图标的大小。