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