本頁面詳細說明 CarUiListItem 清單項目的自訂選項。
使用 Car UI 程式庫顯示項目清單的常用模式，是將 CarUiRecyclerView 與 CarUiListItemAdapter 和 CarUiListItem 物件搭配使用。CarUiRecyclerView 自訂功能的相關資訊請參閱 caruirecyclerview。
必要條件
以下內容假設您已瞭解「自訂應用程式」一文中所述的執行階段資源覆蓋層 (RRO)。
關於 CarUiListItem
清單項目可分為兩種高階類型：標題或內容。以下將說明各項功能。
標頭
CarUiListItemAdapter 會將 CarUiHeaderListItem 類型的物件繫結至從 car_ui_header_list_item 版面配置檔案中加載的檢視區塊，該檔案包含下列檢視區塊：
| View | |
|---|---|
title |
標題 TextView |
body |
內文 TextView |
舉例來說，下方的標頭清單項目已設定為顯示標題和內文文字：
內容
CarUiListItemAdapter 會將 CarUiHeaderListItem 類型的物件繫結至從 car_ui_list_item 版面配置檔案加載的檢視畫面。這個檔案包含以下檢視畫面：
| View | |
|---|---|
icon_container |
主要圖示的容器 |
title |
標題 TextView |
body |
內文 TextView |
action_container |
動作檢視區塊的容器 |
舉例來說，下方的內容清單項目已設定為顯示圖示 和切換鈕：
圖示
視清單項目所設定的圖示類型而定，系統會使用下列三個檢視畫面之一做為主要圖示：
| View | |
|---|---|
icon |
標準圖示 ImageView |
content_icon |
內容圖示 ImageView |
avatar_icon |
顯示圖片的 ImageView |
動作元素
系統會根據清單項目的動作類型，最多顯示下列其中一個動作元素檢視畫面：
| View | |
|---|---|
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_supplemental_icon_size 尺寸值定義。疊加這個維度值，即可變更輔助圖示的大小。