CarUiListItem için özelleştirme seçenekleri

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.

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.