CarUiListItem

本文詳細介紹CarUiListItem列表項的自定義選項。

使用 Car UI 庫顯示項目列表的公認範例是將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	內容圖標 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_avatar_icon_outline中定義的形狀。

補充圖標

補充圖標位於操作容器視圖的中心。補充圖標的寬度和高度均由car_ui_list_item_supplemental_icon_size尺寸值定義。覆蓋此尺寸值以更改補充圖標的大小。