Bu sayfada CarUiListItem
liste öğelerine ilişkin özelleştirme seçeneklerinin ayrıntıları verilmektedir.
Öğelerin bir listesini görüntülemek için Car UI kitaplığını kullanmaya yönelik kabul edilen paradigma, bir CarUiListItemAdapter
ve CarUiListItem
nesneleriyle birlikte bir CarUiRecyclerView
kullanmaktır. CarUiRecyclerView
özelleştirmesi caruirecyclerview
kapsamındadır.
Önkoşullar
Aşağıdaki içerik, Uygulamaları özelleştirme bölümünde açıklanan çalışma zamanı kaynak katmanlarının (RRO) anlaşıldığını varsayar.
CarUiListItem Hakkında
Liste öğeleri iki üst düzey türden biri olabilir: başlık veya içerik . Her biri aşağıda açıklanmıştır.
Başlık
CarUiListItemAdapter
CarUiHeaderListItem
türündeki nesneleri, şu görünümleri içeren car_ui_header_list_item
düzen dosyasından şişirilmiş bir görünüme bağlar:
Görüntüleme | |
---|---|
title | Başlık Metin Görünümü |
body | Gövde Metni Görünümü |
Örneğin, aşağıdaki başlık listesi öğesi bir başlık ve gövde metnini görüntüleyecek ş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 şu görünümleri içerir:
Görüntüleme | |
---|---|
icon_container | Birincil simge için kapsayıcı |
title | Başlık Metin Görünümü |
body | Gövde Metni Görünümü |
action_container | Eylem görünümü için kapsayıcı |
Örneğin, aşağıdaki içerik listesi öğesi bir simge ve bir anahtar görüntüleyecek şekilde 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 | |
---|---|
icon | Standart simge ImageView |
content_icon | İçerik simgesi ImageView |
avatar_icon | Avatar simgesi ImageView |
Eylem öğeleri
Liste öğesinin eylem türüne bağlı olarak en fazla aşağıdaki eylem öğesi görünümlerinden biri görüntülenir:
Görüntüleme | |
---|---|
switch_widget | Switch |
checkbox_widget | CheckBox |
radio_button_widget | RadioButton |
supplemental_icon | ImageView |
Metni özelleştir
Hem başlık hem de içerik listesi öğelerindeki metin stili, Araç 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ştirin
İçerik listesi öğeleri hem birincil hem de ek simge içerebilir.
Birincil simge
İçerik listesi öğesi düzeninde simge kapsayıcısında tanımlanmış üç ImageView nesnesi olmasına rağmen, liste öğesinin belirtilen simge türüne bağlı olarak en fazla bir simge görüntülenir. Öğe bağlama zamanında CarUiListItemAdapter
, 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 üst üste yerleştirilebilen boyut değerleri tarafından kontrol edilir. Çeşitli simge türlerinin genişlik ve yüksekliğini belirten boyut değerleri aşağıda listelenmiştir.
Standart simge
Varsayılan olarak standart simgeler eşit yükseklik ve genişliğe sahiptir.
Standart simge | |
---|---|
Genişlik | car_ui_list_item_icon_size |
Yükseklik | car_ui_list_item_icon_size |
İçerik simgesi
İçerik simgesi | |
---|---|
Genişlik | car_ui_list_item_content_icon_width |
Yükseklik | car_ui_list_item_content_icon_height |
Avatar simgesi
Varsayılan olarak birincil simgeler, car_ui_list_item_icon_container_width
boyut değeri tarafından tanımlanan bir genişliğe sahip olan simge kapsayıcı görünümü içinde ortalanır.
Avatar simgesi | |
---|---|
Genişlik | car_ui_list_item_content_icon_width |
Yükseklik | car_ui_list_item_content_icon_height |
Ek simge
Ek simge, eylem kapsayıcı görünümünde ortalanmıştır. Ek simgenin hem genişliği hem de yüksekliği car_ui_list_item_supplemental_icon_size
boyut değeriyle tanımlanır. Ek simgenin boyutunu değiştirmek için bu boyut değerinin üzerine bindirin.