Bu sayfada, CarUiListItem liste öğeleriyle ilgili özelleştirme seçenekleri ayrıntılı olarak açıklanmaktadır.
Araba kullanıcı arayüzü kitaplığını kullanarak öğelerin listesini görüntülemek için kabul edilen paradigma, CarUiRecyclerView nesnesini CarUiListItemAdapter ve CarUiListItem nesneleriyle birlikte kullanmaktır.
CarUiRecyclerView özelleştirmesi caruirecyclerview bölümünde ele alınmıştır.
Ön koşullar
Aşağıdaki içerikte, Uygulamaları özelleştirme bölümünde açıklanan çalışma zamanında kaynak yer paylaşımlarının (RRO) bilindiği varsayılmaktadır.
CarUiListItem hakkında
Liste öğeleri, başlık veya içerik olmak üzere iki üst düzey türden biri olabilir. Bunların her biri aşağıda açıklanmıştır.
Başlık
CarUiListItemAdapter, CarUiHeaderListItem türündeki nesneleri car_ui_header_list_item düzen dosyasından şişirilmiş bir görünüme bağlar. Bu görünümler şunlardır:
| Görüntüleme sayısı | |
|---|---|
title |
Başlık TextView |
body |
Gövde TextView |
Örneğin, aşağıdaki başlık listesi öğesi bir başlık ve gövde metni gösterecek şekilde yapılandırılmıştır:
İçerik
CarUiListItemAdapter, CarUiHeaderListItem türündeki nesneleri car_ui_list_item düzen dosyasından şişirilmiş bir görünüme bağlar. Bu dosya aşağıdaki görünümleri içerir:
| Görüntüleme sayısı | |
|---|---|
icon_container |
Birincil simge için kapsayıcı |
title |
Başlık TextView |
body |
Gövde TextView |
action_container |
İşlem görünümü için kapsayıcı |
Örneğin, aşağıdaki içerik listesi öğesi bir simge ve anahtar göstermek üzere yapılandırılmıştır:
Simgeler
Liste öğesi için yapılandırılan simge türüne bağlı olarak, birincil simge için aşağıdaki üç görünümden biri kullanılır:
| Görüntüleme sayısı | |
|---|---|
icon |
Standart simge ImageView |
content_icon |
İçerik simgesi ImageView |
avatar_icon |
Avatar simgesi ImageView |
İşlem öğeleri
Liste öğesinin işlem türüne bağlı olarak en fazla aşağıdaki işlem öğesi görünümlerinden biri görüntülenir:
| Görüntüleme sayısı | |
|---|---|
switch_widget |
Switch |
checkbox_widget |
CheckBox |
radio_button_widget |
RadioButton |
supplemental_icon |
ImageView |
Metni özelleştirme
Hem başlık hem de içerik listesi öğelerindeki metin stili, Car kullanıcı arayüzü kitaplığında tanımlanan metin görünümü stilleri tarafından kontrol edilir. Liste öğelerinin metin stilini geçersiz kılmak için aşağıda listelenen ilgili stilleri geçersiz kılın.
Başlık stillerini özelleştirmek için:
| Başlık stilleri | |
|---|---|
| Başlık metni | @style/TextAppearance.CarUi.ListItem |
| Gövde metni | @style/TextAppearance.CarUi.ListItem.Body |
İçerik stillerini özelleştirmek için:
| İçerik stilleri | |
|---|---|
| Başlık metni | @style/TextAppearance.CarUi.ListItem.Header |
| Gövde metni | @style/TextAppearance.CarUi.ListItem.Body |
Simgeleri özelleştirme
İçerik listesi öğeleri hem birincil hem de ek simge içerebilir.
Birincil simge
İçerik listesi öğesi düzeninde simge kapsayıcısında üç ImageView nesnesi tanımlanmış olsa da liste öğesinin belirtilen simge türüne göre en fazla bir simge görüntülenir. CarUiListItemAdapter, öğe bağlama zamanında simge ImageView nesneleri için uygun görünürlüğü ayarlar.
Simgelerin genişliği ve yüksekliği, boyutlandırmayı kontrol etmek için yer paylaşımı yapılabilen boyut değerleriyle kontrol edilir. Çeşitli simge türlerinin genişliğini ve yüksekliğini belirten boyut değerleri aşağıda listelenmiştir.
Standart simge
Standart simgeler varsayılan olarak eşit yükseklik ve genişliğe sahiptir.
| Standart simge | |
|---|---|
| Genişlik | car_ui_list_item_icon_size |
| Boy | car_ui_list_item_icon_size |
İçerik simgesi
| İçerik simgesi | |
|---|---|
| Genişlik | car_ui_list_item_content_icon_width |
| Boy | car_ui_list_item_content_icon_height |
Avatar simgesi
Varsayılan olarak birincil simgeler, car_ui_list_item_icon_container_width boyut değeriyle tanımlanan bir genişliğe sahip simge kapsayıcı görünümünün ortasına yerleştirilir.
| Avatar simgesi | |
|---|---|
| Genişlik | car_ui_list_item_content_icon_width |
| Boy | car_ui_list_item_content_icon_height |
Ek simgesi
Ek simge, işlem kapsayıcı görünümünün ortasına yerleştirilir. Ek simgesinin hem genişliği hem de yüksekliği, car_ui_list_item_supplemental_icon_size boyut değeriyle tanımlanır. Ek simgesinin boyutunu değiştirmek için bu boyut değerini yer paylaşımı olarak kullanın.