Auf dieser Seite finden Sie Informationen zu den Anpassungsoptionen für CarUiListItem-Listenelemente.
Das gängige Paradigma für die Verwendung der Auto-UI-Bibliothek zum Darstellen einer Liste von Elementen besteht darin, ein CarUiRecyclerView in Verbindung mit CarUiListItemAdapter- und CarUiListItem-Objekten zu verwenden.
Die Anpassung von CarUiRecyclerView wird unter caruirecyclerview behandelt.
Voraussetzungen
Für den folgenden Inhalt sollten Sie mit Laufzeitressourcenüberlagerungen (Runtime Resource Overlays, RRO) vertraut sein. Weitere Informationen finden Sie unter Apps anpassen.
CarUiListItem
Listenelemente können zu einem von zwei übergeordneten Typen gehören: Überschrift oder Inhalt. Diese werden nachfolgend beschrieben.
Header
CarUiListItemAdapter bindet Objekte vom Typ CarUiHeaderListItem an eine Ansicht, die aus der Layoutdatei car_ui_header_list_item aufgebläht wurde. Diese enthält die folgenden Ansichten:
| Aufrufe | |
|---|---|
title |
Titel-Textview |
body |
Textkörper-TextView |
Das folgende Listenelement für die Überschrift ist beispielsweise so konfiguriert, dass ein Titel und ein Textkörper angezeigt werden:
Content
CarUiListItemAdapter bindet Objekte vom Typ CarUiHeaderListItem an eine Ansicht, die aus der car_ui_list_item-Layoutdatei aufgebläht wurde. Diese Datei enthält folgende Ansichten:
| Aufrufe | |
|---|---|
icon_container |
Container für das primäre Symbol |
title |
Titel-Textview |
body |
Textkörper-TextView |
action_container |
Container für die Aktionsansicht |
Das folgende Element der Inhaltsliste wurde beispielsweise so konfiguriert, dass ein Symbol und ein Schalter angezeigt werden:
Symbole
Je nach dem für das Listenelement konfigurierten Symboltyp wird eine der folgenden drei Ansichten für das primäre Symbol verwendet:
| Aufrufe | |
|---|---|
icon |
Standardsymbol – ImageView |
content_icon |
Inhaltssymbol – Bildansicht |
avatar_icon |
Avatarsymbol – Bildansicht |
Aktionselemente
Je nach Aktionstyp des Listenelements wird maximal eine der folgenden Ansichten für Aktionselemente angezeigt:
| Aufrufe | |
|---|---|
switch_widget |
Switch |
checkbox_widget |
CheckBox |
radio_button_widget |
RadioButton |
supplemental_icon |
ImageView |
Text anpassen
Die Textformatierung in Kopfzeilen und Inhaltslisten wird durch Textstilvorlagen gesteuert, die in der Car UI-Bibliothek definiert sind. Wenn Sie das Textformat von Listenelementen überschreiben möchten, überschreiben Sie die entsprechenden Stile unten.
So passen Sie Überschriftenstile an:
| Kopfzeilenstile | |
|---|---|
| Titeltext | @style/TextAppearance.CarUi.ListItem |
| Text | @style/TextAppearance.CarUi.ListItem.Body |
So passen Sie Inhaltsstile an:
| Inhaltsstile | |
|---|---|
| Titeltext | @style/TextAppearance.CarUi.ListItem.Header |
| Text | @style/TextAppearance.CarUi.ListItem.Body |
Symbole anpassen
Elemente in Inhaltslisten können sowohl ein primäres als auch ein ergänzendes Symbol enthalten.
Primäres Symbol
Im Symbolcontainer im Layout des Listenelements sind zwar drei ImageView-Objekte definiert, aber je nach angegebenem Symboltyp des Listenelements wird höchstens ein Symbol angezeigt. Bei der Artikelbindung legt CarUiListItemAdapter die entsprechende Sichtbarkeit für die ImageView-Objekte des Symbols fest.
Breite und Höhe von Symbolen werden durch Dimensionswerte gesteuert, die überlagert werden können, um die Größe zu steuern. Unten finden Sie die Dimensionswerte, die die Breite und Höhe der verschiedenen Symboltypen angeben.
Standardsymbol
Standardsymbole haben standardmäßig dieselbe Höhe und Breite.
| Standardsymbol | |
|---|---|
| Breite | car_ui_list_item_icon_size |
| Größe | car_ui_list_item_icon_size |
Inhaltssymbol
| Inhaltssymbol | |
|---|---|
| Breite | car_ui_list_item_content_icon_width |
| Größe | car_ui_list_item_content_icon_height |
Avatar-Symbol
Standardmäßig sind primäre Symbole in der Symbolcontaineransicht zentriert. Die Breite dieser Ansicht wird durch den Dimensionswert car_ui_list_item_icon_container_width definiert.
| Avatar-Symbol | |
|---|---|
| Breite | car_ui_list_item_content_icon_width |
| Größe | car_ui_list_item_content_icon_height |
Symbol für ergänzende Informationen
Das ergänzende Symbol ist in der Ansicht des Aktionscontainers zentriert. Sowohl die Breite als auch die Höhe des ergänzenden Symbols werden durch den Wert der Dimension car_ui_list_item_supplemental_icon_size definiert. Überlagern Sie diesen Dimensionswert, um die Größe des ergänzenden Symbols zu ändern.