CarUiListItem

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

使用 Car UI 庫顯示項目列表的公認範例是將CarUiRecyclerView與CarUiListItemAdapter和CarUiListItem對象結合使用。 CarUiRecyclerView自定義包含在caruirecyclerview中。

先決條件

以下內容假定您了解自定義應用程序中描述的運行時資源覆蓋 (RRO)。

關於 CarUiListItem

列表項可以是兩種高級類型之一，標題或內容。每個都在下面描述。

標題

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尺寸值定義。覆蓋此尺寸值以更改補充圖標的大小。